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Preface 


The current documentation for the Indus GT Disk [orve for Atari 
Computers has been improved in several ways: 


, 


The seperate application, owner, and DOS manuals have 
been combined into a single volume with larger, more 
readable type and has been spiral bound for easier access 
to the information. 


The DOS XL Operator's Guide has been replaced with a 
much lengthier and more comprehensive DOS XL 
Operator's Guide and Reference Manual. 


A spelling checker, GTSPELL, has been added to the GT 
Estate Wordprocessor. 


A RAM Disk utility program, RAM130.COM, has been 
added to i:e DOS XL Systems Master Diskette. This 
program allows owners of the Atari 130XE to use their 
“extra” 64K of RAM as a small Disk Drive. 


Indus constantly strives to improve its products and services. 
However, the only way we can inform you of any of these 
improvements after you have already purchased one of our products is 
by your completing and returning the enclosed WARRANTY 
REGISTRATION CARD. Although we have attempted to deliver to 
you the best disk drive available on the market at this time, completing 
this card will allow us to inform you of any product improvements, 
software updates, new accessories or add-in products that may later 
become available -- continuing to deliver better product quality and 
performance, and better protecting the investment you have made in 
purchasing one of our GT Disk Drives. 


ii 








Master Table of Contents 


ERG See NEE 8 PEOEMcnes dacevea cai cae ccewes HU eccccoccdl 


This manual covers the initial installation and set-up of your disk drive, 
introduces the basic disk functions, care of your diskettes and tells you 
briefly about Disk Operating System functions. Major sections/subjects 
covered in this manual are: 


INTRODUCTION * INSTALLATION * DISK DRIVE OPERATION * CARE 
AND USE OF DISKETTES * INTRODUCTION TO DOS * BEGINNING 
WITH DOS * DOS ERROR MESSAGES * DISK DRIVE ERROR CODES * 
NOISE RADIATION NOTICE. 


GT Estate WordProcessor with GT Spell...................20 


nis manual describes the operation and use of the your wordprocessor 
anc spelling checker. Writing and formatting your reports and 
correspondence will be much easier and have a more professional 
appearance when finished by using this product. Major sections/subjects 
covered in this manual are: 


INTRODUCTION * USING THIS MANUAL * SYSTEM HARDWARE 
REQUIREMENTS * LOADING INSTRUCTIONS * USING THE GT ESTATE 
WORDPROCESSOR * STATUS CODES OF THE EDITOR * ERROR 
MESSAGES OF THE FORMATTER * USING YOUR SAMPLE LETTERS * 
USING THE GT ESTATE WORDPROCESSOR IN DOUBLE DENSITY * 
USING THE GT SPELL PROGRAM 


NN 068 doc cd ons ccacsvucdvesuanesediaivsaeeesape 


This manual describes the sctup and use of the GT Data Manager. 
Database managers are extremely useful programs for organizing lists of 
information which you make. Several small sample databases are 
included and include address book type information, lists of your 
persona! oook library and video tape collection, and so on. Major 
sections/subjects covered in this manual are: 


INTRODUCTION * HARDWARE REQUIREMENTS * GETTING STARTED 


* RECORD AND FILE LIMITS * THE MAIN MENU * SAMPLE DATA 
BASES * HELPFUL HINTS 


iii 


RoE PENDEE EET UMEMNUOET: Jone cccccncescccccccvevenccevécccoecll 


This manual describes the installation and use of a spreadsheet. The 
whole revolution in personal computers is said to have begun due to the 
use invention of this type of program which takes the tedious and time 
consuming arithmetic chores out of financial planning, doing forecasts, 
etc. Major sections/subjects covered in this manual are: 


INTRODUCTION * REQUIRED ACCESSORIES * OPTIONAL 
ACCESSORIES * SETTING UP * USING THE GT ALBERT E. 
SPREADSHEET * THE SCREEN WINDOW * CELL ENTRY (ESC) * 
MOVING THE SCREEN WINDOW * RECALCULATING WORKSHEET 
FORMULAS * DISK OPERATIONS * PRINTING (OPTIONAL) * 
CLEARING THE WORKSHEET (NEW) * ENDING A GT ALBERT E. 
SPREADSHEET SESSION (QUIT) * SAMPLE WORKSHEETS 


DOS XL Operator's Guide and Reference Manual..........95 


This manual provides comprehensive information on the use and features 
of DOS XL. Major sections/subjects covered in this manual are: 


YOUR INDUS GT AND DOS XL * INTRODUCTION * GETTING STARTED 
WITH DOS XL * THE DOS XL MENU * THE DOS XL COMMAND 
PROCESSOR * THE DOS XL BOOT PROCESS * DOS XL AND THE 850 
INTERFACE MODULE * SOME ADVANCED CAPABILITIES OF DOS XL * 
USING DOS XL WITH THE ATARI BASIC CARTRIDGE * CONTROLLING 
DOS XL WITHOUT BEING THERE * USING DOS XL WITH ASSEMBLY 
LANGUAGE * DISK FILE STRUCTURE * SYSTEM MEMORY MAP * 
ERRORS * SHIFTING INTO SYNCHROMESH * A SHORT GLOSSARY * A 
DECIMAL/HEX/BINARY CONVERSION TABLE * OTHER FILES ON 
YOUR DISKETTE 


iv 





Indus GT Disk Drive for Atari 


Owner's Manual 


By Ron Kelly 





Indus GT for Atari Disk Drive Owner's Manual 


NOTICE: Future Systems, Inc. reserves the right to make improvements in the product 
described herein at any time and without notice. 


DISCLAIMER: Future Systems, Inc. shall have no liability or responsibility to the 
purchaser or any other person or entity with respect to any liability, lnss or damage 
caused or alleged to be caused directly or indirectly by this manual or its use, including 
but not limited to any interruption in service, loss of business and anticipatory profits 
of consequential damages resulting from the use of this product. 


COPYRIGHT (C) 1986 by FUTURE SYSTEMS, INC. 


This manual is published and copyrighted by Future Systems, Inc. All rights are 
reserved. This document may not, in whole or part, be copied, photocopied, 
reproduced, translated or reduced to any electronic medium or machine readable form 
without prior written consent of Future Systems, Inc. 


The word ATARI and the ATARI logo are registered trademarks of ATARI 
CORPORATION. ATARI CORPORATION was not in any way involved in the writing 
or other preparation of this manual, nor were the facts presented here reviewed for 
accuracy by that company. Use of the term ATARI should not be construed to 
represent any endorsement, official or otherwise, by ATARI CORPORATION. 
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INTRODUCTION 


This manual will cover two primary functions. First, the installation of your new 
Indus GT Disk Drive, and second, as an introduction to the Disk Operating System, 
usually referred to as DOS (pronounced Doss). 


The disk drive is designed to be fully compatible with all other Atari peripherals, and 
its basic operation is similar to the standard Atari drive. Some of the major differences 
are the half- height size and the addition of an operator panel equipped with a two digit 
LED display for displaying the unit number, track number, and drive error codes. 


The disk drive uses a 5 1/4 inch single or double density soft or hard sectored "floppy 
diskette” which is capable of storing and retrieving data in a random-access fashion at 
a speed far superior to tape. The DOS stores the information by file name, controls 
the allocation of space on the diskette, and does a variety of other important 
housekeeping functions for you. 


Besides this manual, enclosed in the shipping container, you should have received the 
INDUS GT disk drive, a data cable, an AC power module and cable, and a System 
Master Diskette. This diskette contains the Disk Operating System as well as the 
utility programs you will need for operating your disk drive. 


Installing the disk drive and using the DOS are quite simple, as you will learn from the 
following pages. 


Te 
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INSTALLATION 


Unpack your new Indus GT Disk Drive along with the accessories included making sure 
you save any packing materials for possible future use. 


Installing Your First Drive: 


If you are installing the first disk drive on your Atari system then carefully follow 
these step by step instructions: 


1. Turn the POWER OFF to ALL components of your computer system. 


2. Plug the AC power module into the wall socket. Make sure the POWER switch is 
turned off on your drive and plug the smaller end into the back of the disk drive in the 
socket marked POWER IN adjacent to the POWER switch. 


3. Plug one end of the Data Cable into the jack marked PERIPHERAL on one of the 
sides or rear panel of your computer, depending on the model, and the other end into 
one of the matching I/O jacks on the rear of the disk drive. If you have a tape unit, 
piug it into the remaining I/O jack at the rear of the drive. 


4. Note the group of small stide or rocker type switches numbered | through 4 on the 
back panel. The first two are used to set the drive number (1-4) and normally come 
factory set to the Drive 1 positions which are both on, as illustrated with arrows on 
the rear pancl. The "ON" position for a slide type switch is up as indicated by an up 
arrow. The "ON" position for a rocker type switch is the top pressed down. Switch 3 
is turned on to select the Double Density option (it informs your disk operating 
system and/or drive the density of the diskette you normally expect to have installed 
in this drive; if there was a diskette present in the drive when your system was powered 
up your drive will automatically try to read that diskette and will switch to its density). 
Switch 4 has been reserved for potential future expansion use and should always be Icft 
off. 


5. Locate the power switch at the rear of the disk drive and switch it on. Open the 
plexiglass door by pressing downward on the square button and then following the 
door closing diagram which was supplied with your drive to ensure that your drive's 
door is properly closed and ready for use. 


6. Remove the System Master Diskette from it's paper sleeve, holding the label end 
up carefully insert it into the drive until it clicks or catches. In order to provide 
adequate supplies of disk drive mechanisms, Future Systems uses several sources of 
high quality disk drives for your use; the door opening mechanisms on these drives are 
different and you should refer to the separate door opening diagram which was supplied 
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with your drive at this point in order to assure that the drive is properly operated. 
PLEASE NOTE: i r i j i 


oy A eer epee ‘is 


7. Remove any cartridges, including BASIC, from the computer then turn the computer 
power on. The DOS menu will appear on the screen as soon as the Disk Operating 
System has loaded. If you leave the BASIC cartridge in ( or if you own an Atari 800XL 
or 65/135 XE) the READY prompt will appear, type DOS to get the menu. 


Installing multiple Drives: 


You can connect up to four disk drives, as well as other devices, to your Atari system. 
The disk drives and tape unit are connected to each other in a “duisy-chain" fashion, 
using the Data Cables supplied with each device. A sct of switches is located on the 
rear of your drive to set in the drive number. 


1. Turn the power off to your disk drive, Looking at the rear of the drive, note the 
four slide or rocker type switches labeled | through 4. 


2. The first two switches numbered 1 and 2 are used for setting the drive number. For 
Drive #1 the switches are both switched on, that is both slides are up or both of the 
rocker type would be pressed down at the top. For Drive #2 switch 1 should be off 
with switch 2 left on. Drive #3 is the reverse, switch 1 on with switch 2 off. And 
Drive #4 is set with both switches off. Switch 3 is used for selecting the Double 
Density option when turned on (slide switch up, or top of rocker pressed down). The 
positions are noted on the back panel for your reference. (Switch #3 informs your disk 
operating system and/or drive the density of the diskette you normally expect to have 
installed in this drive; if there was a diskette present in the drive when your system 
was powered up your drive will automatically try to read that diskette and will switch to 
its density). Switch 4 has been reserved for potential future expansion use and should 
always be left off. 


3. Connect the second Data Cable to the unused I/O jack on the rear of the first drive 
and the other end to a jack on the second drive. Repeat this “daisy-chaining" process 
for each additional drive with the tape unit, if any, connected to the last |/O jack, 
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DISK DRIVE OPERATION 


Your new Indus GT Disk Drive has a number of new operational features included on the 
operator's panel. First you will notice a two digit display on the far left. In the 
middle are three more LED (Light Emitting Diode) indicators, and to the right are four 
pushbuttons. 


The three LED's in the center are each labeled to represent their function, The POWER 
LED is illuminated whenever power is applied to the drive. When the drive is in use 
the BUSY LED is illuminated. The rightmost LED marked PROTECT is illuminated 
whenever the diskette in the drive has been write protected, either by covering the 
square notch on the diskette, or the adjacent pushbutton has been pressed to set write 
protect mode, This button is a very useful feature as it allows you to write protect a 
diskette without having to remove it from the drive to place a sticker over the notch. 


The other three pushbuttons to the far right set the display mode for the two digit LED 
display. This will display the TRACK as the default unless an error occurs, in which 
case the error code will be displayed automatically, 


Pressing the button labeled DRIVE TYPE will display drive number 1 - 4, which are set 
by the four switches on the rear panel and the density ("A” for 810/1050 compatible 
single density, "3" for 815 compatible double density, and "C" for 1050 compatible 
double density). 


Pressing the TRACK button will switch back to displaying the current track numbers 
on the display. Pressing the ERROR’ button will allow display of the last error 
code encountered. If an “E-" is displayed then no error has occurred. The error code 
can be reset by holding the ERROR bulton down while pressing the TRACK button. 


When displaying an error code on the two digit LED display the left character will be a 
letter to represent the type of operation being performed when the error occurred. The 
letter "G" (represented by what looks like a number 6 with the horizontal center bar 
missing) tells you the error occurred during a "Get" or read operation, The letter "P" 
tells you the error occurred during a "Put" or write operation. The letter "F" tells you 
the error occurred during a "Format" operation. 


The right digit of the two digit LED display will show a number 3 for a LOST DATA 
ERROR, a number 4 for aCHECKSUM ERROR, a number 5 for a RECORD NOT FOUND 
ERROR, a number 7 for a WRITE PROTECT ERROR, or a number 9 for a VERIFY 
ERROR. A full explanation of these error codes is contained in the final section of 
this manual entitled "DISK DRIVE ERROR CODES" 


. 


IMPORTANT NOTE: Copy-protected programs may generate errors when loading. 
This is no cause for alarm, as long as the Program continues to load, as this is usually 
a part of the protection scheme. 
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CARE AND USE OF YOUR DISKETTES 


The magnetic surface of a floppy disk is somewhat similar to that of a cassette Lape. 
Each of the media consists of a plastic base coated with a magnetic material that your 
data can be stored on and read back from at a later time. The primary difference is that 
the floppy disk is enclosed in a flexible black plastic envelope rather than a hard 
plastic case, and that the floppy disk is designed for quick random access similar to the 
way you can quickly select a particular song when using & phonograph record versus 
the serial selection process using cassette tape. 


Much like the phonograph record and cassette tape, floppy disks must have proper care 
to maintain their usefulness. Therefore the following precautions are offered. 


1. Store your diskettes away from direct sunlight. Keep them away from excessive 
heat. They can easily become warped. 


2. Kezp your diskettes away from excessive moisture and humidity. Never wet or wash 
a disertte. The diskette envelope contains it's own cleaning material. 


3. Jo not bend your diskettes, handle them with care when inserting or removing 
frc. your disk drive. They must turn freely inside their protective envelope. 


4. Store your diskettes in their specially treated paper sleeves and keep them standing 
on edge to prevent damage to the magnetic surface. 


5. Never touch the magnetic surface of the diskette where it is exposed through the 
oval slot in the protective envelope. Fingerprints can damage the magnetic medium 
and render the surface unusable. 


6. Never allow your diskettes to be stored within the reach of a magnetic field, such as 
some T.V.'s or the telephone when it rings. Magnetic fields can erase the data on your 
diskettes. 


7. Do not attach paper clips or staples to your diskettes. 


&. Do not write on your diskettes with a ball-point pen or pencil. Use a felt-tip pen 
to mark on the diskette label, or write on the label before you put it on the diskette. 


9. Do not use pencil erasers on diskette labels as the eraser dust is very abrasive and 
will damage the diskette. 


10. Do use good common sense in handling and storing your diskettes, as the data 
you save may be your own. 


8 


| I ai i alla ae 


LL 


Indus GT for Atari Disk Drive Owner's Manual 


INTRODUCTION TO DOS 


The Disk Operating System is a program which allows you and your programs to 
communicate with your disk drives where information is stored on the diskettes. This 
information is stored in what is called a “file”. This file is given a name so that you, 
or your program, may recall the information at any time it is needed. 


DOS allows you to create and manipulate your files so that you may SAVE, LOAD, or 
RUN a program, list the DIRECTORY, RENAME a file, DELETE files, LOCK or 
UNLOCK files, FORMAT new diskettes, and COPY files or entire diskettes. 


Before you can successfully communicate with your drives, DOS must be loaded into 
your computer's memory. This process is known as "BOOTING". Most 
preprogrammed diskettes you buy will have a form of DOS already on them and they 
will boot automatically. 


in order to use new (blank) diskettes for data and program storage they must first be 
“FORMATTED". And to enable them to boot automatically, the DOS files must be 
wansferred onto them from the System Master Diskette. 


These, as well as several other functions of DOS, will be explained to you in the 
following pages. 


For complete in depth information on Atari's DOS obtain a copy of Atari's DOS manual 
from your dealer; a full description of the DOS XL that has been supplied with your 
Indus GT disk drive may be found in a later section of this manual. 
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BEGINNING WITH DOS 


PLEASE NOTE: This section briefly describes Atari DOS 2.0, which is a menu 
driven, single density only disk operating system (90 K Bytes only). Future Systems 
has provided with your drive a single and double density disk operating system, DOS 
XL, to let you store a full 180 K Bytes of information in a type "B" format (815 
compatible). Although the order of the two menus and their corresponding alphabetic 
character assignments are different, the basic functions performed by these programs 
are very similar. For a more detailed description of Future Systems DOS, please refer 


Booting: 


The process know as “booting” will load the Disk Operating System into the 
computer's memory and allow disk communications to take place. If you try 
communicating with the disk drive without loading the DOS, the message BOOT 
ERROR" will print on the screen. 


Follow the procedure below to load DOS: 
1. Turn the disk drive and computer off and remove any cartridges from the computer. 


2. Turn the disk drive on with the power switch on the rear. The POWER LED should 
light and the BUSY LED should go off. 


3. Open the plexiglass cover on the disk drive by pressing downward on the square 
plastic button and then following the door opening diagram supplied with your drive 
mechanism. 


4. Remove the System Master Diskette from its protective sleeve and hold it by the 
label end up and carefully insert the end with the oval cutout into the drive until it 
clicks and close the latch by following the door closing diagram which was supplied 
with your drive. 


5. Tum the computer power on. The DOS will automatically load into the computer's 
memory. 


Always turn the computer on after you have turned the disk drive on and inserted the 
diskette. If you tur the volume up on the TV while DOS is loading, you will be able 
to hear a series of tones. This lets you know that DOS is being loaded into the 
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computer. When DOS has finished loading you will see the DOS menu on the screen as 
it appears below: 


DISK OPERATING SYSTEM II VERSION 2.0 
COPYRIGHT 1980 ATARI 


A. DISK DIRECTORY I. FORMAT DISK 
B. RUN CARTRIDGE J. DUPLICATE DISK 
C. COPY FILE K. BINARY SAVE 
D. DELETE FILE(S) L. BINARY LOAD 
E. RENAME FILE M. RUN AT ADDRESS 
F. LOCK FILE N. CREATE MEM.SAV 
3. UNLOCK DOS FILE 0. DUPLICATE FILE 
H. WRITE DOS FILES 
SELECT ITEM OR <RETURN> FOR MENU 
Directory: 


To obtain a directory listing on the screen, select item A on the menu by typing an A 
and pressing <RETURN>. Press <RETURN> again and the directory will be listed on 
your screen as seen below: 


DIRECTORY--SEARCH SPECLIST FILE? 
DOS SYS 036 

DUP SYS 041 

AUTORUN 001 

627 FREE SECTORS 


SELECT ITEM OR <RETURN> FOR MENU 
From the directory listing you can determine that there are three files on the Master 
Diskette, DOS.SYS, DUP.SYS, and AUTORUN. Also noted is the number of sectors 
each file has used and how many sectors remain unused. 
Naming Files and Filespecs: 
There are just a few rules to remember when naming files. First, the maximum length 
of the name is eight characters, The only characters that are allowed are the letters A 


through Z and the numbers 0 through 9. The first character of a name must always be a 
letter, 


11 


Indus GT for Atari Disk Drive Owner's Manual 


Filenames may also have extenders. This is a suffix added to the file name to 
designate its type or usage such as BAS for a BASIC program, TXT for text file, or 
DAT for a data file. To add an extender type the filename, a period, then the extender, 
such as MYPROG.BAS. 


A filespec is the device code, followed by the filename, plus it’s extender, if any. The 
device code for the first drive is "D1:". The full filespec for the program above would 
then be DI:MYPROG.BAS. The device codes for additional drives are, of course, D2: 
for the second drive, D3: for the third, and D4: for the forth. 


When prompted "DIRECTORY--SEARCH SPEC, LIST FILE?” you may enter a specific 
filespec for the type of files you want listed. 


Wild Cards: 


To enable you to be more selective and to eliminate excess typing, & special feature 
has been installed in DOS called the “wild card". This is similar to the joker in a deck 
of cards, where it can be substituted for any other card. The same can be true with file 
names, which enables manipulation of groups of files as we shall sce. 


There are two types of wild cards allowed; an asterisk (*) which can stand for any 
combination of letters and numbers, or the question mark (?) which stands for only one 
letter or number. 


Let's say you have 15 BASIC files along with 30 data files on a diskette that you 
wanted a directory listing of. Instead of having to look at the entire directory listing 
of 45 files, you could enter D1:*.BAS for the filespec instead of just pressing 
<RETURN> again when obtaining the directory. This option would then list just the 
15 BASIC programs with the name extension BAS and not the data files with the TXT 
extension. This same procedure may be used with several other menu options. 


The question mark (?) is used as a substitute for a single letter or number in a file 
grouping such as FILE].TXT, FILE2.TXT, FILE3.TXT, FILE4.TXT. In this case the 
question mark could be used in a filespec in place of the number (e.g. DI:FILE?. TXT) 


Formatting Blank Diskettes: 


WARNING! This option completely erases all information stored on the diskette in 
the drive sclected. Make sure you use only a blank disketle or one you want to crase 
and reuse. 


All new diskettes must be formatted before they can be used. The Format Diskette 
option (I.) is used for this purpose as well as to crase all the files on an old diskette in 
order to reuse it. This process of formatting will organize the surface of the diskette 
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into tracks and sectors so that the data you store goes into a predetermined place where 
DOS can later find it. 


Select option I by pressing the I key and the <RETURN> key. The computer will ask 
“WHICH DRIVE TO FORMAT?". You enter a 1. The computer will then request a 
verification by responding with “TYPE *Y’' TO FORMAT DISK 1". You then respond 
by entering a Y. 


This process takes approximately two minutes. When finished the message "SELECT 
ITEM OR RETURN FOR MENU" will print on the screen again. 


If you get an ERROR - 173 message on the screen, this indicates that the blank 
diskette has a bad sector and DOS was unable to format it. Use another blank diskettc 
and return the bad one to your supplier. 


Installing DOS on New Diskettes: 


Uniess you are jormatting a new diskette to be used only for data storage, and never for 
booling, you will generally need to install DOS onto the new diskettc. Use option H 
ty Write New DOS Piles by typing a H foilowed by <RETURN>. 


The computer will prompt you with "WHICH DRIVE TO WRITE DOS FILES TO?". You 
respond by entering a 1 and pressing <RETURN>. The computer again responds with 
“TYPE ‘Y' TO WRITE DOS TO DRIVE 1". Type Y <RETURN> and the computer 
responds "WRITING NEW DOS FILES”. 


Deleting Files: 


An empty formatted diskette contains 707 sectors of which DOS will occupy 81. If 
you have installed DOS and later find you need the space and don't require booting on 
that diskette, you may want to use the Delete function to remove the DOS files. 


Any time you need to remove unnecessary files from your diskettes, use the Delete File 
option by typing a D <RETURN>. The computer will respond with “DELETE FILE 
SPEC". You type "DI:MYFILE.ANY” and the computer responds TYPE ‘Y' TO 
DELETE... DI:MYFILE.ANY. Enter a Y <RETURN> and the job is accomplished. 
Using wild cards you may delete an entire group of files. 


The drive or diskette must not be write protected when trying to delete a file or you 
will get an ERROR 144 message on your screen. If this happens you will necd to 
temove the write protect sticker covering the square notch on the side of the diskette. 
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Copying files: 


Use the Copy File option for making a copy of a file on the same diskette. If you 
want to transfer the file to another diskette then use the Duplicate File option. 


Since DOS won't allow you to have two files with the same name on the same diskette, 
you will need to specify another name or extension for the new file. Wild cards are 
not allowed unless you have more than one drive. 


To make an identical copy of MYPROG.BAS on the same diskette enter option C by 
typing aC <RETURN>. The computer responds with "COPY--FROM, TO?", you enter 
D1:MYPROG.BASD1:MYPROGI.BAS <RETURN>. Check the directory after the 
operation is completed to see the results. 


Duplicating Files: 


This option is used when you need to move files onto another diskette. Use wild cards 
with this option if you wish to duplicate a group of files. If you are using a single 
drive, you will be prompted by the computer when to insert cither the source or 
destination diskettes. You may want to use the write protect feature on the source 
diskette or drive to insure preventing erasure of your source diskette. 


To duplicate MYPROG.BAS onto another formatted diskette, select option O by typing 
the letter O and pressing <RETURN>, the computer will respond with the prompt 
“NAME OF FILE TO MOVE?". Type D1I:MYFILE.BAS and press <RETURN», the 
computer will instruct you to "INSERT SOURCE DISK, TYPE RETURN”. Make sure 
your SOURCE diskette is inserted then press the <RETURN> key. The source diskette 
will be read and then the computer will prompt you to "INSERT DESTINATION DISK, 
TYPE RETURN". Remove source diskette and replace it with the DESTINATION 
diskette before pressing <RETURN>. This will continue until the file is completely 
transferred. 


To transfer all files to another diskette, use the wild card option *.* as follows: 
Computer requests "NAME OF FILE TO MOVE?", you respond by typing D1:*.* 
<RETURN>. The computer will continue to prompt you until ali files have been 
transferred. 


Duplicate Disk Option: 


This option will duplicate an entire diskette sector by sector whereas the duplicate file 
option transfers a file at a time. This option also duplicates the directory, so any files 
that may have been on the destination diskette are lost. Just like the duplicate file 
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option, duplicating a disk will involve swapping between source and destination 
diskettes until the process is completed. 


To obtain an exact copy of an entire diskette sclect item J by typing the letter J 
followed by a <RETURN>. The computer responds with "DUP DISK - SOURCE, DEST 
DRIVES?", you enter 1, 1 and press <RETURN>. The computer will begin its series of 
prompts to insert either the SOURCE or DESTINATION diskettes. Make sure you have 
inserted the diskette the computer has requested before pressing <RETURN>. 
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DOS ERROR MESSAGES 


The error messages following are listed with their common causes Ww enable you to 
take the appropriate action to correct the problem, 


BOOT ERROR: 


This error is caused by trying to access the disk drive when DOS has not been properly 
loaded into the computer's memory. Check to sce if the disk drive is turned on, the 
disk drive latch is properly closed, the diskette is placed correctly in the drive, and 
that it contains the Disk Operating System. 


ERROR- 2 AT LINE... : 


This error is caused by cither an error in the program that ts running or @ peripheral 
device used by the program not being turned on or present. Check the following: 
Make sure that your system has cnough computer memory (RAM) to run that program. 
Make sure all the peripherals are turned on or that the program is not looking for a 
peripheral that does not exist. Finally check to sce if there is an error in the BASIC 
program at or around the line number mentioned in the error message. 


ERROR 21: 


You have attempted to load a | ie which is not a program, that is perhaps a data or text 
file. Make sure you specify a program name and not a text or data file name when 
using the LOAD or RUN commands, 


ERROR 138: 


This error occurs when the computer is not communicating with the disk drives. Make 
sure the Data Cables are plugged into the computer and the disk drive properly. 


ERROR 144: 

Either there is an incompatibility problem with the diskelic und Gis, arive you are 
using or you are trying to save data onto a wrile protected Giskeilc Siake sure the 
square notch on the side of the diskelle is not covered or that the drive has not been 
placed into write protect mode, 

ERROR 170: 


computer has not found the program you are trying to load. Check the spelling of 
the program name and make sure you have the proper diskette by listing the directory 
and that the proper drive with that diskette is being accessed. 
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These error codes are generated by the disk drive, not usually as a fault of, or an error 
in, the drive, but rather as a means of helping you identify problems with the media or 
data when the drive encounters difficulty in reading data or writing to faulty media. A 
full explanation follows for the disk drive error codes which are displayed when an 
error occurs or when pressing the ERROR pushbutton on the drive's operator pancl. 


Remember, errors encountered while loading a copy-protected program arc quite normal 
as they are usually a part of the protection installed by the publisher. Ignore any of 
these as long as the program continues to load. If a copy protected program won't 
load, it is generally defective and should be returned for replacement. 


The left digit will display one of four characters, a "G" for a Get or read error, a "P" for 
a Put or write error, or a "F" for a Format error. An "E-" is displayed when no error 
has occurred. The display can be cleared back to “E-” by holding the ERROR 
pushbutton down while pressing the TRACK pushbutton. 


The right digit displays one of four numbers, 3, 4, 5, 7 or 9. The explanations, 
causes, and solutions for each follow. 


ERROR 3 = LOST DATA ERROR 


This error may occur with any of the three types of operations if the proper data has 
not been transferred to and from the diskette. A bad diskette (defective or worn out), or 
a magnetically “glitched” diskette may account for this. Retry the operation (save, 
load, elc.), or remove the diskette and switch the drive's power off and on again and 
then retry the operation. Make sure all I/O connectors arc snug. If the problem 
persists with just the one diskette then retry the operation with a another formatied 
diskette. 


ERROR 4 = CHECKSUM ERROR 


This error may occur with either a read or write operation. A checksum is made when 
data is written and read back from the diskette to ensure that a "bit" didn't get lost 
along the way. This error indicates that one did just that. The operation you were 
performing should be retried at least ten times to get past this error. Try to re-save the 
program or re-write the record. A BASIC program which has recurring problems of this 
type should be saved onto another diskette. 
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ERROR 5 = RECORD NOT FOUND ERROR 


This error may occur on either a read or write type of operation. This is generally 
considered a non-recoverable error and the program file or data record which is at fault 
will usually have to be re- created. This is the time when your back-up disk comes in 
handy! If this error occurred while you were saving a program or file, then you should 
immediately try re-saving the program or file onto another diskette, as the copy inside 
the Atari's memory at that time should be intact. 


ERROR 7 = WRITE PROTECT ERROR 


This error may occur on either a write or format type of operation and indicates that 
your drive is in the write protect mode. You must enable wriline »v making sure the 
diskette in the drive doesn't have a write protect sticker and/or resetting the PROTECT 
Status by pressing the PROTECT pushbutton on the drive. 


ERROR 9 = VERIFY ERROR 


This error may occur on either a write with verify or a format type of operation and 2 
indicates that the drive has not been able to successfully read information that it has 

just written. On a write with verify type of operation this would most likely indicate 

that information within the data block of the sector is mis-written. In a format verify 

error (F9), the mis-written bits of information could be in the address, data or a 
checksum areas of the diskette surface. In either case the operation should be retried. 

If the problem persists, another diskette should be tried, since the problem is most 

likely related to defects in a particular part of the diskette surface. 


Whenever a particular diskette causes a drive error, it is a good idea to play it safe and 
make another copy. If the problem persists then reformat the problem diskette and 
copy the files back onto it from the back-up diskette. If problems still occur on that 
diskette then discard it and use the back-up as your new master. Make sure you make 
another back-up from the new master before using it for any other purpose 


Always make sure you use quality diskettes. If you are using the double density option 
you must use double density diskettes. These may also be used in single density, but 
don't try to use single density diskettes for double density storage. 


_ If you repeatedly have proble:as with your diskettes or drives, then you should make 
sure that you are not storing your diskettes too near magnetic fields such as audio 
speakers, telephones, T.V.'s, or other appliances, or perhaps in a metal container that 
may have become magnetized. If in doubt, then change your storage location. 
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NOISE RADIATION NOTICE 


Section 15.838 of the FCC rules and regulations stipulates that the following 
information be provided to users of Class B computing devices regarding the 
interference potential of the devices and simple measures that can be taken by the user 
to correct the interference: 


This equipment generates and uses radio frequency energy and if not installed and used 
properly, ic., in strict accordance with the manufacturer's instructions, may cause 
interference to radio and television reception. It has been type tested and found to 
comply wiih the limits for a Class B computing device in accordance with the 
Specifications in Subpart J of Part 15 of FCC Rules, which are designed to provide 
reasonable protection against such interference in a residential installation. However, 
there is no guarantee that interference will not occur in a particular installation. If this 
equipment docs cause interference to radio or tclevision reception, which can be 
determines Py surning the equipment off and on, the user is encouraged to try to correct 
ine mlerierence py one or more of the following measures: 


Keonent the receiving antenna. 
Relocate the computer with respect to the receiver. 
Move the computer away from the receiver. 


Plug the computer into a different branch outlet so that the computer and the receiver 
are on different branch circuits. 


If necessary, the user should consult the dealer or an experienced radio/tclevision 
technician for additional suggestions. The user may find the following booklet 
prepared by the Federal Communications Commission helpful: 


How to Identify and Resolve Radio-TV Interference Problems 


This booklet is available from the U.S. Government Printing Office, Washington, 
D.C. 20402. Siock 004-000-0034 5-4. 


IMPORTANT NOTE. This product is supplied with a shielded serial interface cable. 
The use of a cable other than that supplied may defeat the RFI shielding of the 
communications between the computer and the disk drive and is therefore not 
recommended. 
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Introduction 


The GT Estate Wordprocessor(tm) turns your Atari computer into an casy-to-use word 
processor with many of the capabilities found in the most expensive professional 
machines, The GT Estate Wordprocessor provides a simple yet effective tool for your 
writing needs by incorporating a combination of control keys, with which you can 
enter a variety of commands with a single keystroke, and a ‘Command Line’ which 
provides the ability to enter more complex statements, and perform such operations as 
saving and loading text from disk. 


The GT Estate Wordprocessor is a 'screen-oriented’ word processor. This means that 
you can access all of the text that you see on the screen at any given time. GT Estate 
Wordprocessor has many features such as the ability to locate and change all (or some) 
occurrences of any letter, word, or block of text (known as a global search and 
change), insertion and deletion of letters, words, entire lines, and even blocks of text, 
as well as casy movement of large sections within the text. The GT Estate 
Wordprocessor features such formatting options as right margin justification, text 
centering, and automatic page numbering. 


22 








— ee 


c— 


 — 


Indus GT for Atari GT Estate Wordprocessor Manual 
Using This Manual 


Instructions can be dull, tedious and uninformative, with obscure technical language 
obfuscating the exposition (what?). In this manual we will use explanations and 
examples that are easy to understand, and straight to the point. We will try to avoid 
the complications of programming terms, but if it becomes necessary to discuss 
something of a technical nature, we will attempt to simplify and explain everything 
cach step of the way. 


The best way to learn to use the GT Estate Wordprocessor is by trying the various 
commands as you read about them. You will discover the best way to do the things you 
want to do by using GT Estate Wordprocessor and experimenting with different 
combinations of commands. 


If the computer is ‘new’ to you, then we recommend that you read the Atari manuals 
that came with it before you begin using the GT Estate Wordprocessor. This will make 
you more familiar with the ins and outs of the computer as we discuss the various parts 
of the system. 


Notation 


One of the most frustrating and confusing things about a computer tutorial (and this 
goes for the writer as well as for the reader) is the notation used to indicate what you 
enter (or type) into the computer, what the computer prints out on the video screcn, 
and how we indicate a sequence of keys to press or keys that must be pressed at the 
same time. Here are the special notations we have used in this manual along with their 
explanations. 


A letter or word enclosed in brackets (<A>) indicates one of the keys on your Atari 
keyboard. In this case, the ‘A’ key should be pressed. 


<CTRL> 


This refers to the ‘control’ key, located on the left side of the keyboard. In most cases, 
the <CTRL> key is used in combination with another key to tell the GT Estate 
Wordprocessor to execute a special function. The '-' sign will be used to indicate that 
two keys are to be pressed at the same time. 


<RETURN> 


This key is located on the right side of the main keyboard. This key causes the cursor 
to ‘return’ to the left side of the screen. It is used mainly to terminate lines on the 
screen, but some command sequences require that a <RETURN> be pressed at the end. 
When you press this key, a ‘control-M’ is placed in the text. 
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<CTRL>-<A> 


This means that you should press the <CTRL> key, and, while still holding it down, 
you should press the <A> key so that both keys are being held down at the same time. 
Note that pressing the two keys in the reverse order will not produce the same result. 


<ESC><R> 


This means that you should press the keys in a special sequence. In this particular 
example, you should press the <ESC> key, take your finger off of the key, and then 
press the <R> key (You can then take your finger off of that key also.) , 


Spaces and Other Special Characters 


A ‘character’ is anything that appears on your video screen. iver <oaces, which appear 
to be blank, are counted as characters. These are the different iypes of characters that 
can appear on screen: 


Letter Characters 


‘A’ through ‘Z' in upper and lower-case. When GT Estate Wordprocessor boots up, you 
are in the normal typewriter mode of upper and lower case. To lock into uppercase 
letters, hold down the <SHIFT> key and press the <CAPS/LOWR> key. You can return 
to the upper/lower case mode by pressing the <CAPS/LOWR> key once. A word of 
caution here - be carcful to avoid the <Atari symbol> and control <CTRL> keys while 
using the <CAPS/LOWR> key. If you accidently hold down one of these keys as you 
press the <CAPS/LOWR> key, the computer will begin printing control characters or 
graphics characters on the screen, depending on which combination you accidently 
pressed, . 

You can clear this condition and retum to normal upper/lower case operation by 
pressing the <CAPS/LOWR> key once. 


Number Characters 
The numerals ‘0’ through ‘9’, located across the top row of the keyouur 
Symbol Characters 


Those characters that appear above the number keys (like ‘!', "@', ana so on), as well 
as the '+', -', ‘=’, "*', and other keys. 


Control Characters 
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These characters are generated by holding down the <CTRL> key and simultaneously 
pressing a letter key. If a control character is printable, it appears on screen as a 
reverse field upper-case letter (dark letter on a light block background). 


The ZERO Character 
This character generally causes trouble because it is easily confused with the letter ‘O'. 
Text Buffer 


This is the name of the block of memory where your text is stored when you are 
editing a document. This buffer will hold a maximum of about 20000 characters (on a 
48K computer). 


Copy Buffer 


This is the name of a small holding area where you can store a block of your text. This 
buffer, which holds about 4000 characters, is useful for such things as moving 
paragraphs from one place to another, 


Filespec 


This word is used to describe the name of a disk file. It means ‘file specification’, and 
refers to the name you assign to the text you save on disk. These files may contain an 
exact duplicate of what was displayed on the screen, or can be ‘formatted’ to look as 
though the material had been ‘printed’ on paper. Picture these files as being shects of 
paper which contain your text, in file folders with names (filespecs) on them. The disk 
can be thought of as a filing cabinet in which the files are stored. 


Refer to your DOS XL Operator's Guide manuals for a full description of disk files; for 
now, we will provide only the information you need to use files with the GT Estate 
Wordprocessor. 


The Atari computer performs input and output operations (referred to as ‘I/O'), through 
devices such as the keyboard, video display and disk drives. Each device is assigned a 
name. For example, the disk drive is called 'D:' (note the colon after the 'D', which 
must be incladed in the device name). Since you can have more than one disk drive, 
you can also include a drive number. The second disk drive is called 'D2:', and so on. 
When you type in a filespec (using the Command Line commands), you must also 
include a device name. The filespec can include an extender, which can be any three- 
letter combination, following a period. 
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So a complete filespec would look like this: 


* -.- Device name code 

** ... Device number (optional) 

**; --- Colon terminates device name 

se eeeeeeee ... File name (up to 8 letters and numbers) 
ee eeeeeeee -.. Separator (required with extender) 

oe, eeeeeeee ove - Extender (up to 3 letters) 


D2:EXAMPLE.TXT 


If you don't include an extender, the GT Estate Wordprocessor will put the extender 
“TXT” on the name for you. When you look at the directory listing for the data disk, 
the ". TXT" will remind you that this is a "TeXT" file. Refer to your DOS XL Operator's 
Guide for more information on file specs and disk files. 
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System Hardware Requirements 
GT Estate Wordprocessor comes on a normal DOS XL compatible, single density disk. 
The minimum hardware required is: 
* Any Atari computer computer with a minimum of 48K RAM 
* Indus GT Disk Drive or equivalent 
* Atari compatible printer - serial or parallel, dot matrix or letter quality 
(Your printer will need to be set in “Automatic Line Feed with Carriage Return” mode. 
Your printer manual should be consulted as to how this should be accomplished on 
your particular printer.) 
* Atari Printer Adapter Module (Optional. Required if printer does not have Atari direct 
connect interface built in.) 

Loading Instructions 

Tur your computer system off. Then turn the disk drive on. Place the GT Estate 
Wordprocessor disk in your drive with the label side up. Now turn on your Atari 


computer and the program wil! automatically load and run. 


After the GT Estate Wordprocesso: title page and copyright statement appear on the 
screen, press any key io enicr the EDITOR. 
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Using the GT Estate Wordprocessor 


There are basically two parts to the GT Estate Wordprocessor: the EDITOR, which ts 
used for text entry, and the FORMATTER, which is used for the output of text. The 
EDITOR is your direct link to text material and to commands that you include in the 
text to control the FORMATTER. Think of the EDITOR as your input controller and the 
FORMATTER as your output controller. 





The EDITOR 


When GT Estate Wordprocessor loads, the copyright message is displayed. Press any 
key to begin text entry. When the editing screen appears, you will sce a line at the 
top of the screen containing groups of letters and numbers. This line is called the 
‘status line.’ It contains information about the status of the GT Estate Wordprocessor 
system. Reading from left to right, you will see C:, A:, R:, and L:, each followed by a 
number. These letters have the following meaning: 


C: The current column position of the cursor is displayed following the colon. A text 
line may contain up to 255 characters. 


A: The accumulated number of characters preceeding the cursor (all the way to the 
beginning of the text) is indicated after the colon. 


R: Indicates the remaining number of characters that can still be typed in without 
exceeding memory limitations. The number will vary depending on how much text you 
have already typed in and how much memory you have installed in your computer. 


L: Shows how much space is left in the ‘copy buffer.’ A maximum of 4096 (4K) 
characters can be copied at one time. 


At the right side of the status line is the word ‘OK". This indicates that you are in the 
normal operating mode. This ‘OK’ is one of several two-letter messages that may 
appear at this position on the screen. This ‘message window’ will inform you of errors, 
jet you know when the copy buffer is open, and do other things which we will discuss 
later. 


At the bottom of the screen is a line of dashes, known as the ‘Command Line’. This 


line is used to enter special instructions for the GT Estate Wordprocessor to execute, 
such as loading or saving text. 
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Below the status line, you will see a white block character at the upper Icfi side of the 
screen (this corner is called the ‘home’ position). The white block is called the ‘cursor.’ 
It shows you where the next character you type will appear on the screen. 


To begin entering your text, just start typing. As you type, the cursor will move from 
left to right until it reaches the 20th character position on the screen, and the line 
counter will increment, displaying the current position on the linc. 


If you hold a key down for more than a half second or so, it will begin to repeat on 
the screen, and will keep repeating until you release the key. 


When you are typing text on the screen, the editor is always in the ‘insert mode’, 
which means that what you are typing is being ‘inserted’ into the text. If there is 
anything after the cursor on the screen, then what you type will appear before the 
existing text. 


The GT Estate Wordprocessor provides you with a method with which you can tailor 
the length of your lines in memory for easy management of text on the screen. When 
you get to the point where you would like to finish the current line, press the 
<RETURN> key and a new line will be started. As you will sce later, if formatting 
commands are included in the text, the <RETURN> has no effect on printout - it only 
serves as a line terminator for displaying the text on the screen. However, if no print 
formatting instructions are included in the text, the formatter will treat the <RETURN> 
as a normal carriage return (and line feed), and the text will be printed just as it appears 
in memory. 


Ordinarily, you will not use lines longer than 80 characters for normal writing, but the 
GT Estate Wordprocessor allows lines of up to 255 characters in length (including the 
mandatory <RETURN> at the end of the line). This allows the creation of forms, charts 
and other special applications. When you reach a line's 250th character, the computer 
will beep a warning with each key stroke. After the 255th character, the cursor will 
disappear entirely and any further characters that you type will be lost. GT Estate 
Wordprocessor has a tendency to slow down during input when the lines get over a 
hundred or so characters long. So just for the sake of speed, you should keep the lincs 
as short as convenience allows. 
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The Commands 


There are two command levels in the GT Estate Wordprocessor: Controls, which 
execute immediately, and Statements, which are executed from the Command Line at the 
bottom of the screen. Once you have learned the various commands, it becomes almost 
second nature to move back and forth between the two levels. 


Be sure you know which command level you are operating on so that you do not 
accidentally alter the text. For instance, typing <CTRL>-<X> will erase the preceeding 
line in the text buffer, while typing <ESC><X><ESC><ESC> (which appears as SXS#) 
on the Command Line will cause an exit to DOS which will kill any text you may have 
in memory! Therefore, be cautious and double-check every statement you write on the 
Command Line before you execute it. 


Each control command is executed by first holding down the <CTRL> key and then 


pressing one of the keys indicated below while still holding down the <CTRL> key. 
Here is a summary of the commands: 


Editing Command Summary 


NOTE: All commands require the <CTRL> key to be held down first. 


<CTRL>-<B> Cursor to bottom of text 
<CTRL>-<C> Close copy buffer 
<CTRL>-<G> Repeat last COMMAND LINE 
<CTRL>-<H> Delete previous character 
<CTRL>-<l> Insert TAB 

«CTRL>-<J> Insert copy buffer contents 
<CTRL>-<K> Erase contents of copy buffer 
<CTRL>-<L> Invoke print formatter 
<CTRL>-<O> Open copy buffer 
<CTRL>-<T> Cursor to top of text 
<CTRL>-<U> Delete next character 
<CTRL»>-<X> Delete previous line 


<CTRL>-<Z> 


Delete next line 
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<CTRL>-<UP ARROW> Cursor to beginning of previous line 
<CTRL>-<DOWN ARROW> Cursor to beginning of next line 
<CTRL>-<LEFT ARROW> Cursor one character backwards 
<CTRL>-<RIGHT ARROW> Cursor one character forwards 
<CTRL><DELETE> Delete next character 


Note:<CTRL>-<L> is a special control code, used to invoke the FORMATTER. It is 
usually followed by text formatting commands which will be discussed later. 


These control commands can be executed with the cursor located anywhere in the text. 
If any character other than those shown in the list is typed, it will be displayed in the 
text as a reverse-field control character, 


When we talk about cursor movement, there are two types we are concerned with; ‘non- 
destructive’ movement, in which the cursor moves around in the text without causing 
any changes to take place, and ‘destructive’ movement, which, as you may well 
imagine, causes the text to change in some way as the cursor passes over it. Here is a 
more detailed look at the <CTRL> key functions, grouped into categories of action: 


Cursor Movement (non-destructive) 
Controls in this group move the cursor within the text, without changing the existing 
text. We'll use the sample text you just entered to illustrate what happens with each of 
these commands. 
<CTRL>-<B> 


This moves cursor to bottom of the text. This command places cursor at the end of all 
text in memory. If you press this combination , the cursor will go to the bottom of 
the text on the screen. 


<CTRL>-<T> 


This command places the cursor just before the first entry in the text buffer. Press this 
combination and you will sce the cursor jump to the top line of text. This will be 
most useful to make certain you are printing or writing the entire text since the LP: 
(list to printer) and WD: (write to disk) commands will print or write only the text 
following the cursor. 


<CTRL>-<up arrow> 


31 


Indus GT for Atari GT Estate Wordprocessor Manual 


This command positions the cursor at the absolute beginning of the previous line, at 
the left side of the screen. Try this command and watch the cursor move backward 
through the copy. 

<CTRL>-<left arrow> 


This command slides the cursor one to the left, while moving the character previously 
in that position one place to the right. 


<CTRL>-<right arrow> 


This command moves the cursor to the right (or down to the next line if at the end of a 
line), by one position, and slides the character in that position to the left. 


Cursor Movements (destructive) 
These controls move the cursor and alter the text in some way as the cursor is moved. 
<CTRL>-<H> 
This command works exactly the same as the <BACK SPACE> key. It deletes the 
character before the cursor and moves the text following the cursor back to the left one 
position. 
<CTRL>-<I> 


This command actually places a tab command, <CT RL>-<I>, into the text and the 
cursor moves one position to the right. 


<CTRL>-<U> 


This command operates exactly like the <DELETE> key. It erases the character to right 
of cursor and moves any text following it to the left by one position. 


<CTRL>-<X> 


This command deletes the all text from the current cursor position tu ne previous 
carriage return (CTRL-M). 


<CTRL>-<Z> 


This command deletes all text from the current cursor position to the next carriage 
return (CTRL-M). 


32 








Indus GT for Atari GT Estate Wordprocessor Manual 
Copy Buffer Controls 


Let's take a detailed look at the use of the copy buffer. The following group of controls 
access the copy buffer. 


<CTRL>-<C> 


This command closes the copy buffer to further input. Use this before moving the 
cursor to a new location, after filling the copy buffer. 


<CTRL>-<J> 


This command inserts the contents of the copy buffer at current cursor position. Just 
move the cursor to the position you wish to place the copy of the buffer contents, and 
press the keys. The contents of the copy buffer are duplicated in the text, and anything 
after the current cursor position is moved to the end of the duplicated text. 


<CTRL>-<K> 
This command emrties the copy buffer, and restores the buffer memory counter. 
<CTRL>-<O> 


This command opens copy buffer. Position the cursor at the END of the text you wish 
to duplicate in the copy buffer, and press this key combination. You may now move 
the cursor to the HEAD of the text to be copied (using any of the cursor movement 
commands), and press <CTRL>-<C> to close the buffer. 


To use the copy buffer, place the cursor at the END of the text to be duplicated, open 
the buffer with the <CTRL>-<O>, and use the cursor movement controls, <CTRL>- <Up 
Arrow> (move to beginning of previous line), <CTRL>-<Right Arrow> (move one 
character backward) or <CTRL>-<T> (cursor to beginning of text), to place the cursor at 
the START of the area to be copied, then close the buffer with a <CTRL>-<C>. 

If you are trying to accomplish a block move of text, you can fill the buffer and erase 
the original lines as you go, using the <CTRL>-<H> (delete previous character) or 
<CTRL>-<X> (delete previous line) commands. 


Any text you may wish to add (using the procedure outlined above) will be added to the 
beginning of the current contents, of the copy buffer, so be careful. It is best to move 
one section at a lime, and clear the buffer after each use. Also, be sure to close the 
buffer after filling it with the text you wish to preserve, before moving the cursor 
anywhere else in the text. Strange things will happen to the contents of the buffer, 
such as erasing characters at the beginning, if you move the cursor forward in the text 
while the copy buffer is still open. 
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Special Controls 


<ESC> 
When you press this key while you are in the EDITOR, it transfers control to the 


Command Line. After you have entered whatever command you want, pressing this key 
twice <ESC><ESC> will execute the command and return contro! to the EDITOR. 


<START> 
Printer control switch. Pressing <START> during output to a printer (or other device) 


will stop the output, and display the message ‘LIST ABORT WITH START’. You can 
then press the <RETURN> kcy to return to the EDITOR with the cursor positioned at 


the spot that printing stopped. 
<DELETE> 


This command operates exactly like <CTRL>-<U>. It erases the character to right of 
cursor and moves any text following it to the left by one position. 
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The FORMATTER 


One of the features that makes the GT Estate Wordprocessor so versatile is its ability 


to format and print your text. You can control suc 


page length, margin justification, paragraph indentation and page numbering. 


Print Formatter Command Summary 


NOTE: These commands must be preceeded by a <CTRL>-<L>, 


<A><T/F> Autoline feed after paragraphs 
<B><n> Set form length to ‘n' lines 
<C><T/F> Center text lines 

<D><n> Insert ‘n' line feeds 

<E><n> Indent paragraphs ‘n' spaces 
<F><T/F> Right margin justification 
<G><n> Set form width to ‘n' characters 
<K> Cancel previous print formats 
<L><n> Sets left margin to ‘n’ 

<N><Tnv/F> Page numbering starts at ‘n’ 

<O> Reset margins and auto line feed 
<P> Advance paper to top of form 
<R><n> Right margin set at ‘n’ 

<S><n> Set number of lines per page to ‘n' 
<W><character> Writes character directly to printer 


The Format Commands 


Now lets examine the print FORMATTER command structure. 


<CTRL>-<L> 
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Begin entry of formatting commands. All formatting commands must be preceeded by 
a <CTRL>-<L>, and terminated with a <RETURN>. Most format lines can be placed 
anywhere in your text. Format commands preceeding the cursor are ignored during list 
operations. 


When you press <CTRL>-<L>, a reverse-field ‘L’ is displayed on the screen at the 
current cursor position. If you enter <CTRL>-<L><RETURN>, with no format 
commands, a new line will start. Usually this is done to define a new paragraph, but 
you may also use it to prevent the FORMATTER from merging two separate lines into 
one. Each command line, even an empty one, starts a new line and puls a space 
between two paragraphs. 


Here are the commands used to control the print formatting - I’ indicates True, which 
means the function is activated. ‘F' indicates False, which turns the function off. 


<A><T/F> 

Automatic line feed after each paragraph. Default is False. This causes a line-feed 
character to be sent to the printer after each paragraph is printed. This can be used to 
separate the text in a clearer fashion. 

<B><n> 

Define new form-length. Default value is 66. The length of the form must be greater 
than or equal to the number of lines per page. This is used by the FORMATTER as 4 
counter for advancing the paper to the top of the next form. 

<C><T/F> 

Center text lines. Default is False. This will cause the printed text to be centered 
between the left and right margins (if left and right margins were defined carlicr). This 
command has priority over right margin justification. 

<D><n> 

Insert 'n' line-fecds. This command causes ‘n’ line-feeds to be seni to ine output 
device. This is useful for preparing such things as forms, which have 4 tol of space 
between lines. 

<E><n> 

Indent paragraphs ‘n’ spaces. Default is zero. Each time a new paragraph (<CTRL>- 


<L>) is printed, the FORMATTER will indent the first line by the number of spaces 
you indicate. This only works after the definition of the right margin has been entered. 
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F><T/F> 


Right margin justification. Default is false. This command gives your text a 
professional look by adjusting each line so that the right margin is even (‘justified’). 
The FORMATTER accomplishes this by adding spaces between the words in each line 
it prints out. The FORMATTER requires that the right and left margins be set, 
otherwise it will not know to which column it should justify. 


<G><n> 
Define new form width. Default is 80 characters. 
<K> 


Erases all previous definitions for printout. Since your GT Estate Wordprocessor will 
remember all of the print format controls from the last document printed during each 
session, beginning each letter or text file with a <CTRL>-<L> <K> will prevent some 
embarassing situations. Please Note: The "K" command will not re-set any special 
control codes that have been sent to your printer using the <W> command (writing 
special hex control codes to your printer). To cancel any special codes of this nature 
you will have to write another special character to your printer -- consulting your 
printer manual. 


<L><n> 


This command sets the left margin at position 'n.' The FORMATTER sends the number 
of spaces indicated by the left margin position before it sends the line of text. The 
default is zero. The value given for the left margin has to be less than the value of the 
right margin. 

<N><T(n)/F> 

Page numbering starts with page ‘n.’ The first page number is not printed. The 
following numbers are printed at the top center of the page. Entering 'F' causes page 
numbering to be turned off. If page numbering is OFF, you can use the 'N' command to 
turn it back ON. 

<O> 


Re-sets the left and right margins as well as the automatic line feed to the default 
values. 


<P> 


Causes the printer to advance the Paper to the top of the next sheet (form feed). This is 
done by sending line-feeds to the printer until the intergal counter reaches the top of 
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the next page, as defined by the form length (normally 66 lines per page). If you are 
doing multiple printouts, include the ‘P’ command at the end of the text to 
automatically force a new page on the printer. 


<R><n> 


Sets right margin to position 'n'. (If n>O and n>left margin and FT (Formatter Truc) 
command has been previously been issued, then it is no longer printed in the ragged 
right mode.) 


<S><n> 


Sets 'n' lines per page. The number of lines per page must be less or equal to the form 
length (see above). Default value is 56 lines per page. Whenever this statement is 
encountered, the FORMATTER will position the paper to the top of the next page, so 
be careful where you put this in the text. If it occurs at the beginning of the text, the 
first page will be skipped. 


<W><character> 


This command writes the ‘character’ directly to the printer and is usually used to send 
control commands directly to the printer. For example, hex $OF (a hex number) sets 
the Epson MX-80 to the narrow font mode. To send a hex value, first type <CTRL>- 
<L>, then go to the command line with <ESC>, type "H’ (which means ‘insert hex 
byte’) followed by the two digit hex value (00 to FF) you want to insert, and finish 
with <ESC><ESC>. This will put the required hex value on the print FORMATTER 
line. 


You can include as many commands as you wish on one line, and it is nol necessary to 
separate them. 


EXAMPLE 


This example will demonstrate how to send a HEX Byte value to your M\4\) printer to 
turn on its condensed font type. 


Type <CTRL>-<L>. Type capital <W>. Type <ESC> (this gets you on command 
line). Type capital <H> (this signifies that you will be writing a hexidec)mai value) 
Type <O> and then capital <F>. Now type <ESC><ESC> and the «| Estat 


Wordprocessor will write what appears to be an inverse capital O next to ti. inverse L 
and capital W you have previously written in your text. At this time you can writ 
additional print format commands, if desired, to compensate for the additioy.) numbe! 
of characters that can now fit on the same line. 
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The Command Line 


Inputs are made on the command line by first pressing the <ESC> key. This causes the 
first dash on the command line to be replaced by a dollar sign ('$'). You can then enter 
multiple commands, separated by <ESC> (which displays the 'S'). To execute the 
command line, just press <ESC><ESC>. This displays the ‘pound sign’ ('#') symbol at 
the end of the line and tells the GT Estate Wordprocessor to begin executing the 
commands you have entered. 


The command line is used for such functions as printing formatted text, retrieving files 
from a disk, and invoking certain editing functions. 


+ ¢ following commands are available from the command line: 


COMMAND LINE Command Summary 


Me ivitcisisnchvdavosssseeavnstes Change string 

PEE nines cine vd iibacepawashenves Delete string 

SEAS os pauaaaprusnsoubace’ canes Erase entire text buffer 
eit ecescaaeainidashe=phieerisey Ansert string 

<L>. vscceseeseeeeseeeInVOKE print formatter 
BEd ci ap sank ised svokwberkouaee Read file from a device 
Ee ricci tides st thn oncatzaiees Search for a string 
CW. scccccrtcccsccsnveccecosenss Write file to a device 
TSE RE ee ene oa Exit to DOS 


Some of these commands can be executed several times by entering a number from 2 
through 255 in front of the command. 


<G> Rereat Command Line 
You can repeat the whole Command Line by using the <CTRL>-<G> command from the 
EDITOR, which brings you back to the beginning of the line. This is possible only if 


the Command Line was ¢) cuted without error. If an error occurred the program jumps 
back to the control mode 
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Here is a description of the parameters used with Command Line instructions. 


<C> String Search and Replace 


Strings preceeded by ‘/ are searched locally, which makes nested searches possible, 
such as $CBaseball is fun$/Base$Soft$#, which causes the substring "Base’ to be 
changed to ‘Soft’ only when it occurs in that context. When the command executes, the 
targetstring is located, then the portion of the string following the slash (/ ) is 
changed to the string following the next <ESC> ($ ) (the last string on the command 
line). If this local nesicd search is not used, as in; SCBascSSoltS#, then the first 
occurrence of the letters Base’ will be changed to ‘Soft’ regardless ot where they appear 

in the text, even if they are in a larger word. 


To repeat a change a number of times within the text, type the number of times the 
change is to be repeated before the letter ‘C.” For cxample: 
$255CBaseball$Softball$# changes the designated string up to 255 times. In the event 
that the string you want to change occurs more than 255 times, type <CTRL>-<G> to 
execute the changes another 255 times. 


<D> Delete a String 

This command erases the next occurrence of a string. To make the same crasure a 
number of times, type the number of changes desired before the letter 'D.’ For example: 
$255DBaseballS# erases the word ‘Baseball’ the next 255 times it occurs (if it occurs 
less than 255 times, the command stops). If the string you want to erase occurs more 
than 255 times, just type <CTRL>-<G>, and the erase executes another 255 times. 

<E> Erase text buffer 


This command erases the entire contents of the text bulfer. Fhe contents of 
buffer are not affected. 


<I> Insert String 


This inserts the specified string at the current cursor position. Repeated inserts can be 
done by typing the desired number of repeats prior to typing the ‘I’ statement. 


<L> Listing Your Text 


This is the command you use to print your text. lt formats and prints the text, 
beginning at the current cursor position, The devices are: 


E: Screen (unsplit) 


P: Printer 
D: Disk (must also include filespec) 
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Please remember when using this command that only the text that follows the cursor 

will be printed. It will be helpful to get in the habit of pressing <CTRL>-<T> 
(moving the cursor to the top of your file) prior to entering the List command 
“. sequence. 


When sending the formatted listing to the screen, a single 'L' (as in $LE:$#) sends 

only the first 38 characters to the screen. An 'L' followed by a 2 ($L2E:$#) sends all 

. characters from the 38th position to the screen-device. If you list the text to a disk 
file, you can subsequently print it out using the DOS COPY FILES command. To send it 
to a parallel printer from DOS, the format is: 


L FILE TO COPY FROM: DI:filespec 
FILE TO COPY TO: iP: 


This is useful for printing multiple copies of the text file. 
<R> Reading A File Into Memory 


<ESC>RD:TEST.TXT<ESC><ESC> reads a file into memory. After the load is 
completed, the cursor is positioned at the end of the text just loaded. If there is any 
text after the cursor before the file is loaded, then it still will be in the same position 
after the file is loaded. Text appearing before the cursor remains unchanged. 


<S> String Search ( No Replacement ) 


This command will search for the next occurrence of the specified string move the 
cursor to the point just past that occurrence. If you include a number (from 1 thru 255) 
before the <S>, the search will stop at that occurrence of the target String. For 
example, $5Sand$# will stop at the Sth occurrence of the word ‘and’ beginning at the 
current cursor position. You can do manual multiple searches, as well, by not including 
a number first, and using the <CTRL>-<G> command to re-execute the search. The 
search will continue until the end of the text is reached. If the target string cannot be 
found, the error message "S?" appears at the upper right side of the screen. 





<W> Saving a File to Disk 
“  <ESC>WDI1:TEST.TXT<ESC><ESC> writes text to file on drive 1. 


In the example, this command writes the file TEST.TXT' to disk. The file is written 
just as it appears in memory. The formatting commands and all contro! characters are 
“preserved in their original form, but not executed during the save operation. Please 

remember when using this command, that only the information which appears after the 

cursor will be written to the disk. This is useful if you want to save the last part of a 

file, but it is a better practice to get in the habit of pressing <CTRL>-<T> (moving the 
“cursor to the top of your text file) prior to beginning the Write to disk command 

sequence. This way you will be certain that you have saved the entire file. 
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<X> Exit to DOS 


This command transfers control to the disk operating system to do such things as look 
at the directory, change filenames, and so on. You can not return to the GT Estate 
Wordprocessor(tm) once you have gone to DOS without reloading the entire program 
by typing "AUTORUN.SYS” with your GT Estate Wordprocessor Master (or a copy of 
it) installed in your disk drive. 


NOTE: When using the command line, all entries should be in upper case letters. 


42 





Indus GT for Atari GT Estate Wordprocessor Manual 
Status Codes of the Editor 
The GT Estate Wordprocessor status codes are two characters long and are displayed in 
L the upper right-hand corner of the screen. If an error occurs, the message is displayed 
and control returns to the EDITOR. These are the error messages and circumstances: 
OK 
_. No errors detected. 
co 


Command line Overflow. No more than 40 characters are allowed on the command 
line. 


E? 


— Invalid character in command line. 


#? 
___ The number in front of a command is larger than 255. 
CH 
i. The CHange command was entered without including a target string. 
— 
1? 
No more space in text buffer. 
' 
Wee, 
Copy buffer is full. 
e 
String not found, or no target string indicated. 
eo 
Something went wrong during ecxccution of the L{ist) command. (Wrong file, printer 
not attached.) 
| baer 
Read/write ermor (File Ges not caist or error occurred during the read/write operation. 
— 8O 





fhe copy buffer is open 
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Error Messages of the FORMATTER 
If an error occurs, the screen will clear and the error message will appear at the top. 
To clear the error condition, press any key, and control passes back to the EDITOR, 
with the cursor at the location of the error, 


CIO ERROR DURING PRINT 


An error occurred during printing of text, or the <BREAK> key was pressed during 
printout. 


ILLEGAL COMMAND 

An unknown command is in the format command line. 

ZERO IS NOT ALLOWED 

A parameter of zero has been entered at a place where it is not allowed. 
T(RUE OR F(ALSE EXPECTED 


A command requiring the T or F condition code has been entered without including the 
correct condition code. 


FORMLENGTH LOWER THAN PAGELENGTH 

As you may expect, the form length must be longer than the page length 
GREATER THAN (RIGHTM-LEFTM) 

You tried to indent more than the difference between left and right margins. 
LEFTM GREATER THAN RIGHTM 

Left margin is bigger than right margin. 

(RIGHTM-LEFTM) TOO SMALL 


During justification, no blank was found in a line. Try to separate a long word into 
syllables. 


LIST ABORT WITH ‘START 
You stopped the printout by pressing the <START> key. 
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Using Your Sample Letters 


Your GT Estate Wordprocessor contains several sample letters and text files that have 
been provided to demonstrate how various features of the GT Estate Wordprocessor 
operate, and how it can take advantage of special features of some popular printers. In 
this section we will review one of these sample letters and analyze the sequence and 
logic behind the print format commands, editing commands, and other elements of the 
wordprocessor. 


We'll begin by loading in the file named "LTR1027.TXT". After booting your GT 
Estate Wordprocessor and exiting the title page by typing any character, you will be 
presented with a blank workspace into which you may begin typing your document. 
Rather than typing an entire letter we will shorten this exercise by reading in a sample 
letter from your GT Estate Wordprocessor diskette. In order to accomplish this we 
must first enter the command line by typing <ESC>. 


The first character on the bottom line of your screen will now change from a “-" to a 
"$". Next you will type "RD:LTR1027.TXT", Signifying to the GT Estate 
Wordprocessor that you wish to Read from Disk (defaulting to drive number one) the 
file named "LTR1027.TXT". In order to cause the GT Estate Wordprocessor to execute 
the command you have just typed you will now type <ESC> <ESC>. Following the 
command which you have previously entered (“RD:LTR1027.TXT"), you will see a “$" 
character followed by a “#". Your disk drive will now become active and in a few 
seconds your screen will be filled with data. You will now be viewing the end of the 
document that has been previously recorded. Typing <CTRL>-<T> will move your 
cursor to the Top or beginning of the letter. From this point forward it will be easiest 
to follow along with this text by using the <CTRL>-<DOWN ARROW> keys. 


The first line of the LTR1027.TXT file is a <CTRL>-<L> (which appears as an inverse 
L on your screen, and is used to invoke the print formatter) followed by a capital K. 
Since your GT Estate Wordprocessor will “remember” the print formats invoked by a 


print format commands. Of course if you have just booted up your GT Estate 
Wordprocessor there will be no previous print format commands to cancel, but you 


The second line reads “Dear Future Systems Customer:" followed by an inverse M. The 
inverse or control M character represents that the <RETURN> key has been pressed at 
this point. Since no format commands have been invoked at this time, the GT Estate 
Wordprocessor will obey the “return” instruction. After line 3, where the right margin 
justification function has been turned on, the control M (<RETURN>) instructions will 
be ignored, as the GT Estate Wordprocessor will merge all of the sentences and make 
its own decisions as to when returns should be inserted until the next paragraph marker 
(<CTRL>-<L>) is encountered. 
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Line 3 reads as follows: “<CTRL>-<L>DILOR70ATFYES”. ‘his transiaies to lum on 
the print formatter, insert one blank line, set the left margin at O, set the mht margin 
at 70, automatically insert an extra linefeed after Paragraphs, turn on the right margin 
justification, and automatically indent 5 spaces at the beginning of each paragraph. 
This shorthand sets up all of the formatting for the next two paragraphs, You will 
notice that the “returns” which appeur on the screen do not appear on the printed 
output of the letter. Also notice how the <CTKL>-<L»> is used tw mark the end of the 
paragraphs. 


Following the second paragraph, to demonstrate the line centering capability of the GT 
Estate eabees we have typed <CIRL>-<L» <C> <I> which turns on the 
centering function. After we have typed “Ceniered Text", we have turned off the 
centering function by typing <CTRL>-<L> <C> <Fs. (Centering has priority over 
right margin justification in your GT Estate Wordprocessor, failing to turn it off will 
Cause each line which is followed by a return character io be centered between the left 
and right margins you have established.) On the same line we have entered a couple of 
additional commands: D1, insert one blank line; and LJ), fe-sclting the left margin to 
the tenth column, The next paragraph is indented demonstrating a common method of 
easily identifying quoted sections, cic. 


Following the indented sub-section is a line reading “<CTRL»-<L2CTDILORAO", which 
translates to: invoke the print formatter, turn on the centering function, insert one 
blank line, re-set the left margin to zero, and re-set the right margin to forty. We will 
be centering the next line and then Selling up a psravraph which will demonstrate 
turning on a special control code function in the Atari 1027 Letter Quality Printer. 


After the "IMPORTANT NOTICE” linc, we have writien <CTRL>-<L> CFEOW followed 
by what appears to be an inverse "O". ‘This translates to: turn off the centering 
function, do not indent at the anes of the next paragraph, and write the 
hexadecimal control code "OC" to the 1027 printer. ‘The hexadecimal control code 
"OC" is interpreted by the 1027 printer as a signal to begin its underlining capability. 
You cause the hexadecimal code “OC” to be wrilten to the printer by first writing a “W" 
(after the print formatter has been invoked by typing <CTRL>-<Ls, of course). Next 
the <ESC> key will need to be pressed, gelling you to the command line. Next the 
<H> key will be pressed to indicate to the GT Estate Wordprocessor that you will be 
entering Hexadecimal information. Now for the <O> and <C>. All that is required to 
have the special code be written into your text at this point is to type <ESC> <ESCs. 
This same sequence may be used to cause other special functions of your printer to be 
turned on and off ( you will have to consult your printer manual for details). It should 
be noted that for multiple contro! code inputs to the printer you do not need to repeal 
the “W", just continue wriling two character hex codes on the command line until you 
have written all of the hex codes required, then hit <RETURNs. 
The next paragraph will appear entire! underlined, if you have an Atari 1027 printer 
or if your printer interprets a hex "OC" as a Signal lo begin underlining. After the 
| underlined paragraph we have written the following line, “<CTRL>-<L>ESLOR70W 
_ followed by what appears to be an inverse “N". This does the following things: 
indents 5 spaces at the beginning of paragraphs aguin, re-sets the left and right 
margins to 0 and 70, and most importantly sends a hex “OE” to the Printer to turn off 
its underlining function. 
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Our only other use of control or print formatter functions in this document, other than 
to seperate peregraphys, is to again eliminate the automatic indentation after paragraphs 
in order that our closing "Very truly yours," and signature will appear flush left, and 
using the line insert command once again. 


Of course this brief overview only scratches the surface of what is possible for your GT 
Estate Wordprocessor, but we hope the exercise has been useful and instructive. 
Printing this sample letter at this point will require only a few simple steps. Type 
<CTRL>-<L> to return you to the top of the letter. Type <ESC> <L> <P> <:> < > 
<ESC>, and et printer will begin typing away. The results you would see, if you had 
an Atari 1027 printer are shown on the next page. 
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Using the GT Estate Wordprocessor in Double Density 


Due to potential conflicts in low memory, your GT Estate Wordprocessor has been 
provided to you in a single density, one or two drive configuration. You can create a 

double density version of the GT Estate Wordprocessor by following 
these simple steps. 


a Insert the Atari BASIC Cartridge into the computer. Note: Some new Atari 
Computer models have BASIC built in. 

2. Boot your original GT Estate Wordprocessor Diskette, then exit from the 
program by typing "<ESC> X <ESC><ESC>". 

as Insert your original System Master Diskette and type "MENU". 

4. From the Menu type “T" for "TO CARTRIDGE”. BASIC will clear the screen 
and say "READY™. 

5. Type “POKE 1802,1" and then press the <RETURN> key. (See your DOS XL 


Operators Guide, Section 7.5 for an explanation of what this does.) 


6. Press the <SYSTEM RESET> or <RESET> button. BASIC will clear the screen 
and say "READY" again. 


7 Type "DOS" and then the <RETURN> key. The DOS XL menu will now be 
displayed. 


8. Type "Q” to Quit the menu. 


9. Follow Section 7.2 in the DOS XL Operator's Guide to create a double density 
diskette. 


10. Follow Section 7.3 in the DOS XL Operator's Guide to copy the GT Estate 
Wordprocessor to the newly initialized double density diskette. Use the command 
"SDCOPY D1:AUTORUN.SYS -Q" and <RETURN> instead of the example given in the 
book. 


11. Re-boot the system using your new double density GT Estate Wordprocessor 
Diskette. 
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GT Speller 
A Spelling Checker for the GT Estate Wordprocessor 


Everyone acknowledges the problems associated with proofreading your own writing. 
It is difficult to see your own mistakes. While the GT Speller program can't critique 
your writing style or grammar it can prove to be a valuable tool to creating good and 
professional impressions with your writing -- no more mis-spelled words. 


Although the program GTSPELLER.COM resides on the same diskette as your GT Estate 
Wordprocessor, it is actually a completely independent and separate program. It can be 
omitted when making back-up copies of your wordprocessor if you want to use the 
same diskette for both your program and storing your text, saving you another 424 
sectors in single density. 


GT SPELLER has an internal vocabulary (words it already understands and knows how 
to spell) of tens of thousands of words. In addition, and more importantly, it can be 
taught new words by creating your own vocabulary file. This is a very simple 
procedure as you will note below. 


PROBLEM PREVENTOR: The GT Speller program has been written to check the 
spelling of documents written with the GT Estate Wordprocessor. In some cases, other 
wordprocessor documents or text files created by other means will not be compatible 
with the format utilized by the GT Estate Wordprocessor, and will not work. In a few 
of these cases, at least in the case of plain text files, if you can open or read the file 
from disk with the GT Estate Wordprocessor, make any necessary corrections to it 
while in memory and then re-save or write it to disk, the GT Speller program will most 
likely work with the re-saved file. 


PROBLEM PREVENTOR: The GT Speller program ignores case (does not 
distinguish between upper and lower case) when checking a document. Therefore, 
SPELL will match spell as well as sPeLL and SpEll, etc. 


Using the GT Speller Program 


In order to see the GT Speller operate you will need to have a file on disk that was 
written by the GT Estate Wordprocessor. To make this easier, we will use the GT 
Speller to check a sample files, LTRMX80.TXT, which already exists on your disk. 


The first step will be to get the spelling checker started. If you are operating from the 
DOS XL Menu, you would first type X (for eXtended menu) and then type GTSPELL and 
hit the <RETURN> key. Of course from the command processor level of DOS XL 
(where you are when you have “Quit to DOS XL") you only need to type GTSPELL. In 
either case the screen you will next see is as follows: 
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GT SPELLER 


A SPELLING CHECKER PROGRAM 
COPYRIGHT 1985 INDUS SYSTEMS 


DOCUMENT FILENAME= 


The GT Speller is now asking you for the name of the document you wish to have 
checked. The name of the document can include the “D1:" or "D2:" specifiers if you 
have more than one drive, or this can be omitted if the document you wish to check 
will be on the same drive as your program (even if it is a different diskette), PLEASE 
NOTE: If you are a one drive system owner, you will normally need to remove your 
speller disk at this point and insert the disk which contains the document file you wish 
to have checked. For our tutorial the document and speller are on the same diskette; we 
will type LTRMX80.TXT (and then <RETURN> of course) as the document filename we 
wish to check. The GT Speller will read the requested file from the disk and then ask 


you to: 


INSERT GT-SPELLER DISK 
THEN PUSH START 


At this point, you would normally re-insert the GT Speller disk in the drive if you are a 
one drive system user, or simply push START if you have two drives and the document 
file was on the other diskette. Again, for our tutorial since the document, Speller, and 
wordprocessor are all on the same diskette, you will only need to press the START key 
at this point to activate spell checking of the requested document. 


The GT Speller will now inform you that it is: 
NOW CHECKING SPELLING 
As it compares the file which it has previously read against it's vocabulary of words 


contained on disk, it will list on the screen those words it did not recognize. In the 
case of our file "LTRMX80.TXT", it will report the following words as un-recognized: 


NOTICIBILITY 
WORDPROCESSOR 


Since the first four “words” are really just formatting instructions for the GT Estate 
Wordprocessor, we won't worry about them being mis-spelled. The last two words, 
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although spelled correctly aren't in the GT Speller's vocabulary. Following the un- 
recognized words listed on the screen, the GT Speller is asking: 


USER DICTIONARY = 


This is the program's way of checking the remaining words against any auxilliary 
dictionaries or vocabulary lists you may have created. Since we do not have any 
auxilliary dictionaries or vocabulary lists to check against at this time, we will just 
press the <RETURN> key causing the following message to be displayed: 


PRESS OPTION TO PRINT ERRORS 
PRESS START TO START OVER 


If you have a printer connected to your system and it is turned on, pressing the 
OPTION key will give you a print out of the above words. (You can use the list 
instead of your memory or handwritten copy when you go back to the GT Estate 
Wordprocessor to use the find or find and replace features to correct your document). 
Or, press the START key and you will be given the opportunity to spell check another 
document. The only remaining feature of the GT Speller program we have not 
examined is the procedure you follow to create your own vocabulary lists or 
dictionaries. 


Creating your own vocabulary/dictlonary 


Creating your own vocabulary lists is as easy as any uther feature of the GT Speller. 
You need only use the GT Estate Wordprocessor, and make a list of the words you want 
to add to the vocabulary or dictionary of the GT Speller. You use upper or lower case, 
list the words in any order, using either the spacebar (spaces) or the <RETURN> key to 
separate the words, Whatever name you give to the list when you write it to the disk 
is the name you enter when the GT Speller asks "USER DICTIONARY =" 


For example, with our file "LTRMX80.TXT", we could create a file containing the 
words: 


NOTICIBILITY 
WORDPROCESSOR 


and name it AUXDICT. When the spelling checker is run again, it will report the same 


words as unrecognized during its first "pass", but when it is given the User Dictionary 
name AUXDICT, it will then report. 
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NO ERRORS WERE FOUND 
PRESS START 


When you are finished checking the spelling of all of the documents you are working 
with, you can be returned to DOS or BASIC by pressing the RESET key. 


PROBLEM PREVENTOR: When entering words into an user dictionary file it is 
wise to double check the spelling of each word with your real dictionary. Otherwise, 
all the time and effort you have gone through creating good impressions with a 
correctly spelled letter or term paper will have been in vain. 
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INTRODUCTION 


Welcome to the world of personal information management! Need a mailing list? 
Houschold inventory record catalog? A list of all your software or books? All of 
these and more are now easily available. 


The GT Data Manager is a unique product in its class. It is extremely flexible and 
powerful. It cven has capabilities that the best selling data basc managers do not 
have. Unlike these “best sellers", however, it was written for the personal market. It 
was designed to be used in the home or small business by average people, not for data 
processing experts. 


You will find the GT Data Manager to be extremely easy to use. Special attention was 
given to the programyYoperator interaction. All operations are menu driven as far as is 
practical. The result is that the program is truly “user friendly”. 


The GT Data Manager is a unique software package that can be utilized in many ways in 
your home or small business. It will maintain information and present it back to you 
either on your computer's display screen or in printed form on your printer. 


You can keep a mailing list on disk and quickly access any individual's address or 
phone number. You can even go further by having the computer list out all names and 
addresses with a selected ZIP code or telephone arca code. You could even list 
everyone whose birthday is in February! 


Keep a list of your houschold property on disk and the GT Data Manager will print out 
your inventory. The GT Data Manager will help you track your expenses when you 
enter all checks and payments into a GT Data Manager format. At the end of the ycar, 
you can quickly obtain a printout of all your expenses or of sclected expenses. With 
the GT Data Manager you can even request a list of all utility payments, mortgage 
payments, or even more. Whatever you keep records for, the GT Data Manager can do 
it for you more accurately and with greater utility. 
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HARDWARE REQUIREMENTS 


The hardware required for using the GT Data Manager is: 


® Any Atarl computer with at least 48K RAM 

- An Indus GT Disk Drive for Atari or compatible drive 
(single or double density) 

° Any Atari compatible printer (Optional) 

° A Printer Interface Module (Optional) 
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GETTING STARTED 


Insert the GT Data Manager diskette into your disk drive and boot up as you normally 
would. The GT Data Manager will automatically load and display the title and 
copyright screen. Press any key and the main menu will appear. You are now ready to 
begin managing your data. 


The main menu will display ten options which may be selected by pressing the 
appropriate key. The options are: 


A. File Directory G. Add New Record 
B. Change Drive H. Modify Old Record 
C. Create File I. Print Records 

D. Modify File J. Display Records 
E. Exit to Dos K. Display Fields 

F. Format a Disk L. Sort File 


If this is the first time you have used the GT Data Manager, then the first thing you 
will need to do is create a file. A review of the sample data base files provided with 
your GT Data Manager is contained in a later section of this manual. Start by placing 
a FORMATTED diskette in drive number one, then select the "C" option from the main 
menu. 


The program will clear the screen and print "CREATE NEW DATA BASE” at the top of 
the screen followed by a prompt which asks you to “Enter File Description". You 
should enter a short description of what the purpose of the file will be. For example, 
you might enter "Address Book” if you are going to use this file to maintain a list of 
names, addresses and phone numbers. The inverse video “bar” tells you the maximum 
length of the description you can enter. In this particular case, you must enter at least 
one character, but may not enter more than 20 characters for the description. This 
kind of prompt will turn up often in the program. 


The next prompt asks you to enter a name for this particular (file) data base. The file 
name can be from one to eight characters long. It must begin with a letter of the 
alphabet and contain no lower-case or special characters. In other words, it may 
contain numbers and upper-case letters. 


The third prompt will ask you “Number of Fields In Record (2 - 8)". This is how many 
different items or parameters you wish to store in each record. For example, in your 
address book you might want to store each person's name, street address, city & state, 
ZIP code, telephone number, and birthday. Each of these would be a field in a record. 


When deciding how many fields you are going to use, keep in mind that you will be 
able to search or sort an entire file based on the contents of a “field”. For example, in 
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the list we just showed you, we lumped “city” and “state” into onc ficld. If we 
anticipate that we might need to do that some day, we should separate that one field 
into two fields. 


It is very important that you carefully think out what you want to store in the file. 
Once you have created a file, you can go back and alter the labels assigned to each 
ficld, but you will not be able to alter the number of ficlds in an cxisting file. This 
leads us to the next prompt. 


When you enter the number of fields that you want in this file (actually it is the 
number of fields in each record in the file), the screen will clear again and you will be 
prompted to enter a “label” for the first field. Enter an appropriate description and 
press the (RETURN) key. For example, in our address book file we probably would 
name (label) the first field "NAME L,F". 


The next prompt asks you for "Field Length (1-37)". This is another of those critical 
parameters that can only be set once. So, again, choose your valuc carefully. Once 
you enter this value and press the (RETURN) key, the screen will clear and the same 
questions will be asked about the next field. This process will continue until you have 
configured all of the fields. 


When all of the fields have been defined, the screen will clear, a summary of the file 
definition will be displayed and you will see a prompt that says “Press (Y) to Suave 
File". Press (Y) if you are satisfied with the record definition. Pressing ANY other 
yey at this stage will return you to the main menu without saving the new file 
cfinition. 
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RECORD AND FILE LIMITS 


While creating the file, one thing you probably noticed near the top of the screen was 
a line that said “Record Size:" followed by a number. You should keep an eye on this 
number as you go through the definition process. This number is the sum of the 
lengths of all the fields defined up to this point. The maximum record length that the 
program will allow is 128. Also, the shorter the total record size you end up with, the 
more data you will be able to store on the diskette, 


How much data can you store in a file? Well, this depends upon several things. The 
first is the length of the records in the file. The second is whether you are working 
with a single or double density disk drive. The third factor is how many other files are 
on the same disk. 


Let's look at an example where you have two double density disk drives. We will 
assume that each record in our example file is 128 bytes long and that we are using 
disk drive number two in double density mode with no other files on that disk. The 
largest size our file could be is about 700 sectors and each sector will hold 256 bytes, 
or about two records. So, we should be able to store 2*700, or about 1400 records on 
that diskette. Equivalent storage on a single density diskette would be about half of 
that, 700 records. Also, if we decrease the length of the records in the file (minimum 
allowed length is 10), then the maximum capacity goes up accordingly. Since the GT 
Data Manager is totally RAM resident, you can achieve similar results with a single 
drive system if you use a separate diskette for your files. There are other less 
important length restrictions, but these will be displayed in the appropriate prompt 
while you are running the program. 
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THE MAIN MENU 


The GT Data Manager main menu gives you twelve major functions from convenient 
menu format. This section of the manual will briefly describe the options available in 
the main menu. 


A. File Directory 


This command gives you a list of the data base files on the disk. The “directory” for 
the data bases is maintained in a file called "INDEX". This file is first generated when 
you create a data base and is updated to include any new data bases you may add to that 
disk. When you use the "A" option, the program will interrogate the INDEX file to 
find out which file names to search for on that disk. All data base files must have the 
extender ".DB” or they cannot be accessed. This extender is automatically assigned to 
all data base files created by the GT Data Manager. 


B. Change Drive 

This command is of use primarily to those of you who have more than one disk drive. 
This command allows you to specify which disk drive will be uscd in all data 
management operations. If you do not use this command, then all operations are 
assumed to be for disk drive number one. 

C. Create File 

This command is used to create a new data base file. The specific details of how to use 
this command are described in the section on "GETTING STARTED". 

D. Modify File 

This command is used to perform two different functions. You may cither delete an 
entire file or alter the labels of the fields in a file. The prompts are clear cnough to 
guide you through. 

E. Exit to DOS 

This command simply returns control to DOS and for the DOS XL it will return you to 
the command processor level “D1:" prompt. If the file MENU.COM is contained on 


your copy of the diskette, you can get a menu simply by typing MENU at this point. 
In order to return to the GT Data Manager, you type "GITBASE” from the command 
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processor level (D1: prompt) or use the “X" (eXtended command) option from the DOS 
XL menu and typing "GTBASE" when prompted for the name of the extended command. 


Be very sure you do not have anything left in memory that you may still need. You 
will have to re-boot the GT Daia Manager or use the procedure described above, even if 
you have a MEM.SAV file on your disk. You may also run into problems if the 
appropriate file such as DUP.SYS is not on that disk. 

F. Format Disk 

This command will format a disk without having to exit to DOS. 

G. Add New Record 


You will use this command anytime you want to add a new record to an existing data 
base file. 


H. Modify Old Record 

This command allows you to alter the contents of an existing record in a file. For 
example, you may have to change the address and phone number of someone who has 
moved. 

I. Print Records 


This command will send any one or all records in a specified file to a printer. You can 
also restrict the printout to portions of a record. 


J. Display Records 
This command will display the contents of any or all records in a data base file. 
K. Display Fields 


This command will display on the screen the fields defined for the records in any one 
or all of the data base files on that disk. 


L. Sort Files 


You will use this option when you want to sort a data base file. You can sort on any 
field in a record. You can sort a file on multiple keys and you can sort in either 
ascending or descending order. The resulting sorted records are saved back to disk for 
later retrieval. NOTE: The sort routine cannot handle a file that is larger than 200 
sectors. 
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SAMPLE DATA BASES 


Several sample data base files have been included on your GT Data Manager master 
diskette to help illustrate various features and typical uses of this program. 


Pressing “A" (Files on Disk) from the GT Data Manager menu will reveal the names of 
these four sample data bases: 


FILE DIRECTORY 
DATA BASES ON THIS DISK 
FILE NAME DESCRIPTION 
VIDEO VIDEO TAPE LIBRARY 
PHONE ADDRESS BOOK 
BOOK SCI Fl BOOK LIBRARY 
ATARIL ATARI UTILITIES 


Let's try a few of the functions of the GT Data Manager! Let's begin by printing a 
record. Pressing “I” for Print Records, will cause you to see the following prompt: 


NO DATA BASE SELECTED YET 
File Name? 


Typing "VIDEO" (since the VIDEO TAPE LIBRARY at 96 files represents the largest of 
the sample data bases) and (RETURN), will generate the following prompt: 


PRINT RECORDS 
WORKING FILE D1I:VIDEO.DB 


A. Print All Records 

S. Print a Single Record 

E. Return to Main Menu 

SELECT ITEM: 
Since we don't need to print all of the records at this time let's press the "S" (no 
(RETURN) key is necessary at this point, as is the case with many other of the single 
character responses of this GT Data Manager). The next sub-menu prompts as follows: 

WORKING FILE DI:VIDEO.DB 


Fields In This File 
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. TITLE 

. VINTAGE 

. CATEGORY 
. UNCUT? 


QUALITY 
Enter Field Number To Search On 


UMshwnNe 


Pressing "1" for TITLE (no (RETURN) key please!) brings up yet another sub-menu: 


WORKING FILE D1: VIDEO.DB 
SEARCH FOR RECORDS 


1. Before Key Field 

2. Beginning with Key Field 
3. Past Key Field 

4. Between Key Fields 


Let's press "4" for Between Key Fields. You will now be prompted as follows: 


WORKING FILE D1:VIDEO.DB 
SEARCH FOR RECORDS 


1. Before Key Field 

2. Beginning with Key Field 
3. Past Key Field 

4. Between Key Fields 


Low Key Field 


Press “A” and the search will begin with all files beginning with the letter Capital A. 
(A (RETURN) is required since we did not enter information into all of the blanks.) 


The screen will now prompt you as follows: 


WORKING FILE D1:VIDEO.DB 
SEARCH FOR RECORDS 

1. Before Key Field 

2. Beginning with Key Field 
3. Past Key Field 

4. Between Key Fields 


Low Key Field 
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High Key Field 





Let's make this a short list and press "C" (and (RETURN) again since this isn’t a single 
character response and we will not have completed all of the blanks provided). The 
next screen presented by the GT Data Manager will appear as follows: 


WORKING FILE D1:VIDEO.DB 


A. Print Entire Record 
S. Print Partial Record 
E. Return to Main Menu 


SELECT ITEM: 


Pressing "S" (no (RETURN)) will cause the GT Data Manager to ask us ficld by field 
whether we want to print or not print. Saying "Y" (Yes) to TITLE, VINTAGE, and 
CATEGORY, and "N" (No) to UNCUT and QUALITY, will result in the screen shown 
below: 


PRINT PARTIAL RECORD 
WORKING FILE D1:VIDEO.DB 
Field Label Print It 
TITLE Y 

VINTAGE z 
CATEGORY 3 § 

UNCUT N 

QUALITY N 


Press (Y) to Print Field 


Pressing "Y" at this point will finally result in your printer beginning to operate. The 
18 records that fall into the A to C category will now be printed. It appears that this 
file has been alphabetically sorted for the 18 records are in perfect alphabetic order as 
shown in Figure 1 on the next page. The next fields, however, seem to be randomly 
organized. 


If we wanted to see this same list of video tapes (A's through C's) organized by 


VINTAGE (Date Issued), we would first sort the file VIDEO by the vintage field, and 
then repeat the steps listed above. 
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VIDEO TAPE LIBRARY PAGE 1 
TITLE VINTAGE 
AIRPLANE 1960 
ALIEN 1980 
ALTERRED STATES 19680 
ANGRY RED PLANET 1959 


ARLO GUTHRIE/SEEGER 1960 
BATTLE BEYOND STARS 1980 


SECKET 1964 
BEING THERE 1979 
BLACK HOLE 1979 
BLAZING SADOLES 1974 
BUGS BUNNY MOVIE 1981 
CAT AND THE CANARY 1939 
CAVEMAN 1980 


CITIZEN KANE 1941 
CLASH OF THE TITANS 19861 
CONAN THE BARBARIAN 1981 
COUNT OF MONTE CRIST 1934 
COUNT OF MONTE CRIST 1975 


Record Count: 18 


Figure 1. 
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CATEGORY 


COMEDY 

SCIENCE FICTION 
SCIENCE FICTION 
SCIENCE FICTION 
MUSIC 

SCIENCE FICTION 
DRAMA 

COMEDY 

SCIENCE FICTION 
COMEDY 

CARTOON 

COMEDY 

COMEDY 

DRAMA 

FANTASY 

FANTASY 

DRAMA 

OR AMA 


Step 1 in sorting the information in the VIDFO data base would be to press the "L” 
(Sort File) key from the main menu. Since we were already working with the VIDEO 
data base file earlier, we are not asked the name of the data base file we wish to work 


with, instead we are given the screen below: 
SORT FILE 


WORKING FILE D1:VIDEO.DB 


Fields In This File 


1. TITLE 

2. VINTAGE 
3. CATEGORY 
4. UNCUT? 

5. QUALITY 


Enter Field Number to Sort on 


Pressing “2" for VINTAGE, adds the following prompt to the screen: 


PRESS (A) FOR AN ASCENDING SORT 
PRESS (D) FOR A DESCENDING SORT 


Pressing (A) for an Ascending Sort, replaces the previous prompt with: 
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PRESS (Y) TO BEGIN SORT 
PRESS (E) TO RETURN TO MAIN MENU 


Pressing (Y) causes the GT Data Manager to go to work. The screen now reports: 
Organizing VIDEO.DB 


Next the computer “beeps” announcing that it has completed it's sort and adds the 
following message to that immediately above: 


Records Loaded: 96 
Records Deleted: 0 
SORT COMPLETED 


Saving DI: VIDEO.DB 


This means that the re-sorted VIDEO.DB file has been saved to disk. Let's test this by 
repeating the steps we began in the middle of page 11, and print out all of the files 
beginning with the A's though the C's. The results should look like Figure 2 below. 


VIDEO TAPE LIBRARY PAGE 1 

TITLE VINTAGE CATEGORY 

COUNT OF MONTE CHRIST 1934 DRAMA 

CAT AND THE CANARY 1939 COMEDY 

CITIZEN KANE 1941 DRAKA 

ANGRY RED PLANET 1959 SCIENCE FICTION 
BECKET 1964 DRAMA 

BLAZING SADDLES 1974 COMEDY 

COUNT OF MONTE CRIST 1975 DRAMA 

BEING THERE i979 COMEDY 

BLACK HOLE 1979 SCIENCE FICTION 
AIRPLANE 1980 COMEDY 

ALIEN 1980 SCIENCE FICTION 
ALTERRED STATES 1960 SCIENCE FICTION 
ARLO GUTHRIE/SEEGER 1960 MUSIC 

BATTLE BEYOND STARS 1980 SCIENCE FICTION 
CAVEMAN 1980 COMEDY 

BUGS BUNNY MOVIE 1981 CARTOON 

CLASH OF THE TITANS 1961 FANTASY 

CONAN THE BARBARIAN 1961 FANTASY 


Record Count: 18 Figure 2. 


Notice that the same 18 records have been printed, but that the VINTAGE column 
proceeds in ascending date order. This might be a way of finding the identity of that 
old movie classic you can't remember the name of but want to see, but what if you're in 
the mood for a comedy? 
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Using the same VIDEO file let's print a list all the COMEDY category files. The 
following represents a quick sequence of answers to the several screen's worth of 
prompts you will use to get the print out: 


% Print Records 

"VIDEO" File Name 

“> Print a Single Record 

“3? CATEGORY - Field to Search On 
ai Search Between Key Fields 
“COMEDY” Low Key Field 

“COMEDY” High Key Field 

“s" Print Partial Record 

“¥" Print Title 

mht Print Vintage 

>) i Print Category 

a. ig Do Not Print Uncut? 

i iy Do Not Print Quality 

<— Print Field 


The resulting printout will appear as shown in Figure 3 below. All 22 video tapes that 
were comedies are now listed for your review. As an additional bonus, since this entire 
data base was most recently sorted by the VINTAGE field, all of your comedies appear 
in ascending chronological order. 


Trm™ vistas cat oy 
CAT AWD Tl Canary 7" COMEDY 
on ar FLINT me cumepy 
te Lies flue - COMEDY 
*RLLY 5 nenoEs i970 oNEDT 
mec OMIT we COMEDY 
us 1970 me 
MATING CAIUS ie commer 
mkt Gaalt (rrmos ane Contre 
POUND FRA eeTE Le a9me Comer 
Pom PaeTeGs STRIEES 1906 Coma 
Seaey & THE Serr Dh comEDy 
TVERY WHECH war aut wn COMEDY 
“oe THO on COmEDY 
LOPE OF aniaw 1979 comer 
mrret Wie ri COMEDY 

ise0 COMEDY 
«i ~~ OmEet 
fealty TOWERS GOSiES PT eT 
i GOO wE ThOT ” cmt 

” conan 
‘SOCRET POLI Cea S bad comeDT 
wr TH. cecum ” cumEDT 
Pecoré Count: 2. 

Figure 3. 
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We have included listings below of information derived from cach of the other data 
bases included on your master diskette: a list of all of the PHONE Address Book files 
where the ZIP code was between 90000 and 99999 (Figure 4); a list of all of the paper 
back books in the BOOK Sci-Fi Book Library (Figure 5); and a list of all of the 
ATARII Atari Utilities published by VERVAN Software Company (Figure 6). These 
sample data bases were included so that you can become familiar with how the GT Data 
Manager operates before beginning to create your own data base files. Losing 
information on sample data bases is not nearly as frustrating as finding out that your 
only remaining diskette was damaged by the family cat and you cannot resave the 
information on which you have spent the last five hours. 


We hope these examples will be helpful for you and that your experiences with the GT 
Data Manager will be rewarding. 


NAME LF STREET CITY STATE ZIP CODE 
JOHNSON , PAUL 1313 STONED DRIVE CUCAMONGA ,CA 91730 
MARTIN, JULIE 362436 BROAD WAY LOS ANGELES,CA 90010 
VERVAN Software 1953 W. llth Street Upland,Ca 91786 


Record Count: 3 


Figure4. 
AUTHOR LF TITLE SERIES BINDING 
ANTHONY , PIERS DRAGON ON A PEDESTAL XANTH PAPER 
BRADLEY ,M. ZIMMER THENDARA HOUSE DARKOVER PAPER 
EVANS ,E.E. MAN OF MANY MINDS PAPER 
HOWARD,ROBERT E. ALMURIC PAPER 
Lae , TANITH ANACKIRE PAPER 
OFFUTT ANDREW J. KING DRAGON PAPER 
PIPER,H. BEAM FIRST CYCLE PAPER 
PIPER,H. BEAM ULLER UPRISING PAPER 
SIMAK CLIFFORD D. SPECIAL DELIVERANCE PAPER 
Record Count: 9 

Figure 5. 
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TITLE 


CASDUP 
Caso1sS 
DISOUP 
DISASM 
FULMAP 
DOWNLD 
DISKPAK 
v-cos 
MICRO-MAP 
POWER SCREEN 


Record Count: 10 


VERVAN Software 
VERVAN Software 
VERVAN Software 
VERVAN Software 
VERVAN Software 
VERVAN Software 
VERVAN Software 
VERVAN Software 
VERVAN Sof tware 
VERVAN Software 


CASS @& DISK 


Figure 6. 
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FUNCTION 


COPY TAPES 
CAS-to-DISK TRANSFER 
COPY DISKS 

6502 DISASSEMBLER 
BASIC X-REFERENCE 
DISK-to-CASS 
OPTIMIZE DISK SPACE 
CONTROL BAUD RATE 
CREATE SCROLLING MAP 
OISPLAY LIST EDITOR 
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HELPFUL HINTS 
Sorting 


The GT Data Manager performs its sorting (ascending or descending) based on the 
ASCII value of the characters (letters or numbers) in the field. For this reason it is 
able to accept fields that contain a mixture of numerical and alphabetic characters, 
This will explain why sorting a file of alphabetic information will place a lower case 
"a" (whose ASCII value is 97) following an uppercase "Z" (whose ASCII valuc is 90). 
In most cases this will not be noticed, but it can be uscful to know, especially if your 
file contains such characters as "$" (ASCII 36), “(" (ASCIL 40), or (SPACE BAR) 
(ASCII 32). 


Deleting Data Base Information 


You should always utilize your GT Data Manager Menu to do any deleting or changing 
of your data base information and not your DOS XL. Your DOS XL will not understand 
the intricacies of updating the INDEX file, and other special record keeping functions 
performed by the GT Data Manager. 


Changing Data Base Selections 


To save you the trouble of selecting which data base you wish to work with for each 
menu selection, the GT Data Manager will assume you are continuing to operate within 
the same data base until you tell it otherwise. The most obvious and casiest way to Ict 
it know you wish to change the data base you wish to work with is to ask it for Files 
on Disk (the "A" choice on your menu) -- if you're wanting to see what other data base 
files exist on your disk, you don't necessarily want to continue operating on the 
currently selected data base. Exiting to DOS will achieve the same result but can be 
more complicated depending on the organization of your master diskette. 


Creating New GT Data Manager Diskettes 


The GT Data Manager can save its information to any previously formatted or 
initialized diskette, single or double density. It is somewhat simpler to operate the GT 
Data Manager if the master and data diskettes are in the same density, however, your 
GT Data Manager operates correctly with DOS XL in both single, double and mixed 
density modes. Consult your DOS XL Operator's Guide for more help in switching 
densities mid-stream, multiple drive systems, etc. 


New master GT Data Managers can be easily constructed by merely initializing a ncw 
diskette (single or double density) and copying the files DOS.SYS and GTBASE.COM 
onto it. This would cause the diskette to boot up in DOS XL's command processor 
mode (with a D1: prompt). You would then type “"GTBASE” and then (RETURN) in 
order to have your GT Data Manager come on. 
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To autoboot your GT Data Manager, the file "GTBASE.COM" could be renamed to 
“AUTORUN.SYS" or you could copy the file "STARTUP.EXC" to your new diskette. 
Either of these alternatives will cause the "EXIT TO DOS" feature of your GT Data 
Manager menu to re-start the GT Data Manager (in effect, you won't be able to exit to 
DOS). 


If you wish to have your GT Data Manager on a diskette containing a normal DOS XL 
menu and other files, copying the file MENU.COM from your DOS XL System Master 
Diskette will accomplish this goal. To start the GT Data Manager you would then 
utilize the menu's "X" (eXtended) command, and type "GTBASE” and (RETURN). 


In any of the above cases, you will have to "CREATE A FILE" from the GT Data 
Manager menu before beginning to use the new master diskette. 


Printing Format 


Although the GT Data Manager has been designed to output the information you want 
to save on paper on a single line, some creativity can be utilized (depending on the 
capabilities of your printer) to produce multi-line output records such as you might 
want for mailing labels. 


In order to take advantage of this particular approach your printer must be capable of 
accepting right and or left margin setting commands. This approach would involve 
constructing a mailing label file whose three or four printing lines would add up to the 
same length (say 25 characters), then telling your printer that it's right and left 
margins are only 25 characters apart, then having your GT Data Manager print the 
addresses for a zip code range you have chosen. A file format for doing this could be 
accomplished as follows: 


Mr. John Q. Public 
270 Main Street ~ 
New York City, NY 1illi 


(The dashes represent blank entries in the appropriate fields and would not print.) 
Additional information fields can be attached to this record, such as phone numbers, 
birthdates, etc., without affecting the ability to print mailing labels. You will have to 
experiment somewhat with the mailing labels you will be using to determine what left 
and right margin settings, form length settings, etc. will work best for you. These 
printer settings must be sent to the printer prior to turning on the GT Data Manager 
and having it print the file for you. 


It should be noted that printing of mailing labels or comparable functions is beyond 
the scope of the GT Data Manager design intent, and that if your printer is not capable 
of accepting programmable margins, etc., you are still receiving the benefit of a very 
sophisticated information management and retrieval system. 
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INTRODUCTION 


Overview 


The GT Albert E. Spreadsheet is an easy to use “Electronic Spreadsheet" which you can 
use to create mathematical models on your Atari personal computer. You don't need 
programming experience to use the GT Albert E. Spreadsheet, which is ideal for 
designing home budgets, balance sheets, math homework, statistical models and 
various other “What If?" models. A convenient menu of commands is always present 
at the top of the screen and the program design is such that models are easy to set up. 


To set up a worksheet, you first determine its size by selecting the number of rows by 
the number of columns. Next a model may be developed by entering labels, numbers 
and formulas into the cells of the worksheet. The math functions which are available 
to you include: addition, subtraction, multiplication, division, exponentiation, and the 
summing of a group (row, column, or block) of cells. Because most spreadsheet 
models will be larger than the display screen, you view the workshect through a 
“window”. This viewing "window" may be moved around the worksheet using the 
arrow keys and the GOTO command. 


An casy to follow example is used to help introduce you to some of the intricacies of 
the GT Albert E. Spreadsheet. The program is extremely user friendly and will recover 
from data entry errors by returning to the command screen. You will find that the G 

Albert E. Spreadsheet is geared more towards personal and business applications than i: 
is towards scientific applications. You will soon find that the GT Albert E. 
Spreadsheet is saving you not only paper, but valuable time. 
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REQUIRED ACCESSORIES 


Minimum 48K RAM Memory 
Atari BASIC Language Cartridge (BASIC is built into 800XL, 135XE and 


65XE computers -- no separate cartridge is 
required for these models.) 
Indus Systems GT Disk Drive for Atari, or equivalent 


OPTIONAL ACCESSORIES 
4 Atari 1027, 1025 or compatible direct connect serial printer 
Atari 850 or compatible parallel interface module and compatible parallel 
printer 
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SETTING UP 


1. Insert the Atari BASIC Language Cartridge in the left cartridge slot of your 800 or 
400 computer, or in the only cartridge slot of your 1200 computer. The 600XL and 
800XL, or 130XE and 65XE models have the Atari BASIC Language already built in to 


the computer. 
2. Turn on your disk drive. 


3. When the BUSY light gocs out, open the disk drive door and insert the GT Albert 
E. Spreadsheet diskette following the instructions included with your disk drive. Insert 
the diskette in drive number one if you have more than one disk drive. 


4. If you are planning to use your printer, turn it and the Atari 850 interface module « 
equivalent on if required for your printer to function. 


5. Turn on your computer and your TV set or monitor. The GT Albert E. Spreadshe. 
will now load, run, and then display the initial “Title Screen”. 
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USING THE GT ALBERT E. SPREADSHEET 


Choosing the Worksheet Size 


After the GT Albert E. Spreadsheet has been loaded into the computer, you will sce the 
initial “Title Screen". The GT Albert E. Spreadsheet program has checked to see how 
much free memory is available (free RAM) in your Atari and then determined the 
maximum number of cells you will be allowed in your worksheet. The number of cells 
in a worksheet is equal to the number of COLUMNS multiplied by the number of 
ROWS. Consequently, you must do some math prior to answering how many 
COLUMNS by ROWS you would like your worksheet to be. The “Title Screen" should 
look something like this: 


GT Albert E. Spreadsheet 
Rev. 2.2 
SIM COMPUTER PRODUCTS, INC. 


Copyright 1982, 1983 David H. Hewit 


YOU MAY HAVE A MAXIMUM OF 112 CELLS 
(TOTAL CELLS = ROWS * COLUMNS) 


ENTER # OF COLUMNS (MIN. 4/MAX. 26) : ? 


First type in the number of COLUMNS you would like on your worksheet, keeping in 
mind that you must have at least 4 and no more than 26. When you hit <RETURN> 
the GT Albert E. Spreadsheet will prompt you with: 


ENTER # OF ROWS (MIN. 18/MAX. 99) :? 


Respond with the number of ROWS desired for your workshect, keeping in mind the 
maximum number of cells allowed. If you should make any errors, the GT Albert E. 
Spreadsheet will simply bounce back to the initial screen and give you another chance. 
After you have entered the size of your worksheei and pressed <RETURN> the message 
“ONE MOMENT PLEASE" will appear for a few seconds and then the screen window and 
command menu will appear. 
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THE SCREEN WINDOW 


Now that you have entered the size of your worksheet, your screen should look 
something like this: 


COMMANDS C8 * R19 

ESC (CELL ENTRY) G(GOTO) 

C(RECALC) R (REPLICATE) P (PRINT) 

S(SAVE) L(LOAD) N (NEW) Q (QUIT) 
A apt B cpt bemic Come eases PLL 

l1- 

2- 

$. 

4- 

5- 


At the top of your screen is the command menu. When choosing a command you 
simply hit the single letter corresponding to your command. The letter should appear 
in inverse video on the display screen. 


In order to use the arrow keys to move the display window, you must hold down the 
<CTRL> key while pressing the arrow key at the same time. If you look at the upper 
right-hand corner of your screen you will see that the size of your worksheet is 
displayed as "Cx * Ry", where "x" is the number of COLUMNS you have chosen and 
"y" is the number of ROWS you have chosen. 


Below the Command Menu is your “Screen Window", which you will use to view the 
information which has been entered into your worksheet. The four COLUMNS which 
are being displayed are labeled across the top as letters (A - D when first initialized). 
The 18 ROWS which are being displayed are labeled down the left side as numbers (1 - 
18 when first initialized), Each individual cell in your worksheet is addressed by its 
COLUMN letter (A - Z) and its ROW number (1 - 99). For example cell Al, cell D3, 
etc. The section of your worksheet which is being displayed on the screen window at 
any time may be changed by using the arrow keys or the GOTO command. These 
commands will be discussed in greater detail in the next section. ° 
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CELL ENTRY 


When entering information into a cell of your GT Albert E. Spreadsheet worksheet, you 
should follow this simple four step process: 


STEP 1: From the command menu press the <ESC> key on your Atari keyboard. The 
GT Albert E. Spreadsheet will respond with the following prompt: 


ENTER 
CELL: ?--- 


STEP 2: Choose the cell into which you would like to enter your data and type the 
COLUMN letter followed by the ROW number; then hit <RETURN>. For example, Al 
<RETURN> or D3 <RETURN>. The letters must be in capitals, but your chosen cell 
does not necessarily need to be visible on the screen window. Your screen should now 
look something like this: 


ENTER PRIOR ENTRY: 
CELL:?D3- 


STEP 3: Now examine the "PRIOR ENTRY" if there is one. If you would like to leave 
the cell as it was, simply press <RETURN> without entering any data and ignore STEP 
4. 


STEP 4: Finally, type in your cell entry. There are three types of entries which we 
will discuss on the next few pages (LABELS, VALUES and FORMULAS). After you 
press <RETURN>, the result of your entry will appear in the appropriate cell (if it is 
presently on the display window). 


If you make an error feel free to use the backspace key. The GT Albert E. Spreadsheet 
will not allow you to enter characters in inverse video nor most graphic characters. 
Try it and see how the program responds. Most other types of entry errors will cause 
the buzzer to sound, an error message to appear, and then return you to the Command 
Menu. 


Entering a Label 


When you would like to enter a LABEL into a cell, first follow the four step process 
described above, at which point your screen should look like this: 


ENTER PRIOR ENTRY: 
CELL:?D3- ENTRY:---------—- 


After STEP 3 you should be ready to enter your LABEL. You must start all your LABEL 
entries by typing a quotation mark. Following the “ you may enter your LABEL as 
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you would like it to appear on the screen. Although you may type in up to 15 
characters per entry, only cight will display to the screen or print to a printer. Please 
note that the program will reject characters in inverse video and most graphic 
characters. This is an example of what a LABEL entry might look like before the final 
<RETURN+> is pressed: 


ENTER PRIOR ENTRY: 
CELL:?D3- ENTRY:"Expense:---—- 


Entering a Value 


Entering numeric values into your worksheet is really quite simple. After following 
the four step process for CELL ENTRY, simply type in the number (no quotation or 
commas please!) and press <RETURN>. You may enter both positive and negative 
numbers, as well as decimal points. This is an example of what a VALUE entry might 
look like prior to pressing <RETURN>: 


ENTER PRIOR ENTRY: 
CELL:?D3- ENTRY:714.89-—------ 


The GT Albert E. Spreadsheet will not accept numbers with more than 9 digits, nor will 
it accept numbers expressed in any type of exponential format. If you wish to enter 
very large or very small numbers, please see the section on FORMULAS for an 
appropriate method. 


Entering a FORMULA & Functions Allowed 


The real power of an electronic spreadsheet such as the GT Albert E. Spreadsheet comes 
from the ability to enter FORMULAS into a cell and thus use the valucs in one or more 
other cells to calculate its contents. Because the rules for FORMULAS are very 
Stringent, we suggest that you study this section very carefully. 


The functions allowed in a FORMULA are: 

+ Addition 

. Subtraction 

° Multiplication 

/ Division 

w Exponentiation 
The five functions above will work with VALUES (eg. 13, 14.98, etc.), with cell 
variables (eg. Al, D3, etc.) or with a combination of the two. 


In addition to these five functions, the GT Albert E. Spreadsheet has one more very 
powerful function: 


Sum 
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The SUM function is used to total all the VALUES in a ROW, COLUMN, or BLOCK of 
cells. When you enter the SUM function into a cell it will total all the VALUES stored 
between the two cells specified. For example, the formula B1:B6 as shown below will 
add together the VALUES in cells B1, B2, B3, B4, BS and B6. 


= ENTER PRIOR ENTRY: 
CELL:?B7- ENTRY:B1:B6------—~- 


You may also total the VALUES in a block of cells by entering a FORMULA such as 
- B1:D3. This will total the cells, B1, B2, B3, C1, C2, C3, D1, D2, and D3. 


CAUTION: If the SUM (:) function is to be used in a FORMULA with other 
' functions, it must be the first function used. Also SUM will not give proper results if 
_ used with numeric VALUES instead of cell references. 


When combining the above functions into a single FORMULA to be entered into a 
cell, there are three characteristics of the GT Albert E. Spreadsheet with which you 
= should be familiar: 


1. All FORMULAS will calculate from left to right, disregarding the rules of 
mathematical hierarchy. For example: 


5-4*20 will result in 20 
-4*20+5 will result in -75 


= 2. Parentheses are not allowed. 
3. Negative numbers should not be used except as the first entry in a FORMULA. For 
' example: 
-_ 
Do not use: 5*-3 or 5*-B2 
Do use: -3*S or -B2*S 
= If this rule is not followed, the GT Albert E. Spreadsheet will not always catch the 


error and incorrect results may be displayed on your screen. 


As mentioned in the previous section, very large or very small numeric VALUES (such 
u as 1234567890, 3.4E+23, or 0,0000000015) cannot be entered directly, because the 
GT Albert E. Spreadsheet will not accept numbers which are more than 9 digits in 
length or in exponential format. But, if you plan your FORMULAS carefully, you 
should be able to force the desired results into your worksheet. The following are a 
= number of examples which show how this can be accomplished: 
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ENTER ENTER SCREEN 
RESULT CELL FORMULA RESULT 
1234000000 Al 10*9* 1.234 1.234E+10 
0.0000000015 Al 1/10000 1E-4 

A2 1.5*A1/100000 1.5E-9 
3.4E+23 Al 10423*3.4 3.4E+23 


CAUTION: If a VALUE in your Atari computer exceeds 9.99999999E97 or are less 
than 9.99999999E-97, a Floating Point Error will result. If this should occur, the 
message "INPUT ERROR - REENTER" will display, the buzzer will sound, and the 
program will return to the Command Menu. 


DIVISION BY ZERO: Whenever a FORMULA attempts to divide by ZERO, the 
VALUE 9 E97 will display in order to avoid causing an error in your spreadsheet. 
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MOVING THE SCREEN WINDOW 


Using the Arrow Keys 


The Atari computer provides arrow keys to help you move the screen “viewing 
window" around the entire worksheet. When using the arrow keys you must hold down 
the <CTRL> key also. When you use these with the GT Albert E. Spreadsheet, instead 
of seeing a cursor move up and down or side to side as you move the arrows, you will 
see the whole screen move in the direction of the arrow key selected. 


Using the GOTO Command 


The GOTO command will allow you to jump your screen window instantly to any 
location of the worksheet for viewing. First press the "G" key to start the GOTO 
Command. The GT Albert E. Spreadsheet will prompt you with this: 


GOTO SPECIFY UPPER LEFT CELL 
CELL— 


Now type in the cell which you would like to see displayed in the upper left of your 


screen window. When you press <RETURN> the viewing window will display the new 
section of your worksheet. 
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RECALCULATING WORKSHEET FORMULAS 


One of the more powerful features of the GT Albert E. Spreadsheet is the ability to 
RECALCULATE the FORMULAS of your worksheet, thus allowing you to play "What 
If?". If you first build a master template for a model, you can then use this “shell” to 
play “What If?". If you have entered new VALUES into cells which are addressed by 
the formulas in other cells, new results will be created when the RECALCULATE 
command is executed. 


To execute the RECALCULATE Command, simply press the "C" key. This message 
should appear while you wait: 
PLEASE WAIT - RECALCULATING 


Because the GT Albert E. Spreadsheet does not automatically RECALCULATE after each 
cell entry, you will find this command to be very necessary when it is time to view or 
print your final results. The amount of time which the RECALCULATE Command takes 
to execute depends on the size of your worksheet. The time in which a small 
worksheet will RECALCULATE is less than 15 seconds, while a large worksheet may 
take a couple of minutes. 


CAUTION: If any of the FORMULAS which are RECALCULATED should result in a 
numeric VALUE which exceeds 9.99999999E97 or is less than 9.99999999E-97 a 
Floating Point Error will result. If this should occur, the message "INPUT ERROR - 
REENTER" will display, the buzzer will sound, and the program will return to the 
Command Menu. 


SOLUTION: A Floating Point Error which occurs during the execution of a 
RECALCULATE Command can be tedious to recover from because you must determine 
by which FORMULA and in which cell the Error was caused. Once you have found the 
guilty cell or cells (by trial and error or intuition) they must either be changed or 
blanked. Cells can be blanked by entering an empty LABEL ( a single quotation 
mark). 


REPLICATION 


Another powerful feature of your GT Albert E. Spreadsheet is the ability to REPLICATE 
the contents of one cell into another cell or block of cells. You will quickly discover 


the value of this command in developing the initial template or “shell” of worksheet 
models. 
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Replicating LABELS 


The first step to perform when you want to REPLICATE a cell containing a LABEL is 
to press the “R" key. The GT Albert E. Spreadsheet will respond with: 


REPLICATE 


SOURCE 
CELL:?— 


Now type in the cell containing the LABEL which you wish to duplicate and press 
<RETURN>. The GT Albert E. Spreadsheet will now respond with: 


REPLICATE 


SOURCE FROM 
CELL:?Al- CELL:?—- 


At this point you should enter the first cell of the group of cells into which you wish 
to duplicate the "source" cell. This should also be the most upper left of this group of 
“destination” cells. 


After pressing <RETURN> your display should look like this: 
REPLICATE 


SOURCE FROM TO 
CELL:?Al- CELL:?A2- CELL:?—- 


Finally, enter the cell which is farthest to the lower right of the group of “destination” 
cells. When you press <RETURN>, this message will appear on the screen while the 
REPLICATE command is executing: , 


REPLICATE 
PLEASE WAIT - REPLICATING 
FORMULAS WILL NOT RECALCULATE 


After the execution of the command line has been completed, the viewing window will 
redisplay and you will see that the group of “destination” cells contain the same 
LABEL as the “source” cell. You will soon find that REPLICATE is especially helpful 
when underlining (" ) a ROW of LABELS. 


Replicating VALUES and FORMULAS 


When you would like to REPLICATE a cell containing a VALUE (such as 45.9 or - 
1024), or a cell containing a FORMULA (such as Al+7.5-C3) you should follow the 
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same procedure that is described above for LABELS. But there is one maior difference! 
After the execution of the command has been completed and the screen has redisplayed, 
the newly duplicated “destination” cells will NOT display the same VALUE as the 
“source” cell. In fact, they will display either as z os or as the previous VALUES — 
from these cells. 


The reason that this result occurs is that the GT Albert E. Spreadsheet does not 
automatically CALCULATE the entries which are REPLICATED to the “destination” 
cells. This of course is a very simple problem to remedy. Simply press the "C” kcy 
to invoke the RECALCULATE command and all your newly duplicated VALUES or 
FORMULAS will be calculated and displayed in the viewing window. You may find 
that it is a good practice to follow most of your REPLICATE commands immediately 
with a RECALCULATE (“C") command so that the proper VALUES are displayed. 


There is also another extremely important and very valuable feature of the REPLICATE 
command. If a FORMULA which addresses other cells (eg. Al+A2-5) is REPLICATED 
from a “source” cell into a group of “destination” cells, the FORMULA will be altered 
in arelative manner. For example, let's assume that the FORMULA B1+A3-44 is 
contained in the cell Al. If you REPLICATE cell Al (source) into cells B2 to D4 
(destination), the “destination” FORMULAS will be altered in the following manner: 


COLUMN 
ROW (A) (B) (C) (D) 
(1) B1+A3-44 
(2) C2+B4-44  D2+C4-44 E2+D4-44 
(3) C3+BS-44  D3+C5-44 E3+DS-44 
(4) C4+B6-44 446-44 E4+D6-44 


The importance of this feature will become apparent to you when you begin utilizing 
the REPLICATE command to build FORMULAS which total ROWS or COLUMNS of 
cells in a worksheet. Please note that FORMULAS will ALWAYS replicate in a relative 
manner; so if you need exact duplicates of FORMULAS, you must enter them 
individually. 
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DISK OPERATIONS 


After building a GT Albert E. Spreadsheet model, you will usually want to save the 
template so that you can come back at a future point in time and work with it. By 
utilizing the SAVE and LOAD commands you can SAVE your worksheets to disk and 
later LOAD them back in, change entries, RECALCULATE, and display new results. In 
effect, you can use the same “master" worksheet over and over again to develop 
different “pages” (separate disk files) of the same model. For instance, each separate 
page or file might represent a new month of your personal budget. 


The Disk Directory 


Each time you decide to use one of the disk commands ("S" or "L"), the GT Albert E. 
Spreadsheet will respond immediately with: 


WOULD YOU LIKE A DISK DIRECTORY? (Y/N) 


At this point, if you press "N" or any other key except "Y", the program will continue 
directly into the SAVE or LOAD procedure. If you feel that information provided by a 
Disk Directory is Proper i such as file names or the amount of free space left on the 
disk, then press the "Y" key. The BUSY light on your disk drive (Drive 1 only) will 
light up and a directory of the files on the disk will appear on your screen as well as 
the number of Free Sectors. If you are not already familiar with this information, then 
refer to your DOS XL Operator's Guide. After you ask for a Disk Directory, your screen 
will look something like this: 


DISK DIRECTORY 


DOS SYS 046 TEMP 001 

BUDGET 087 *BUDGET BAK 086 

*FILE1 BC 037 FILE2 EXT 023 
427 FREE SECTORS 


CONTINUE SAVE/LOAD 
REPEAT DIRECTORY 
RETURN TO COMMAND LEVEL 


At this point you have three choices. First, you may continue with your previously 
selected Disk Operation by pressing "S" or "L". Please note that no matter which of 
two you press (the "S" or the "L"), the GT Albert E. Spreadsheet will continue with 
command which you previously selected from the main Command Menu. Your 
second choice is to repeat the Disk Directory by pressing the "D” key. This is 
especially useful when you would like to check the Directory of a number of floppy 
is to return directly to the main Command Menu and viewing 

the screen by pressing the "C" key. 
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Using the SAVE Command 


The first step to saving any files (worksheets), is to be sure that you have a blank 
FORMATTED disk available. Because you must use your DOS XL to format disks, this 
must be done BEFORE the GT Albert E. Spreadsheet is loaded into your computer 


The next step in saving a GT Albert E. Spreadsheet worksheet is to press the "S" key. 
When you are asked if you would like to see a Disk Directory, procced as described 
above. When you are finished with the Directory option the following prompt will 


appear on your screen: 


FORMAT: D:filename.ext 
ENTER FILE TO SAVE: 


Respond with the name of the file you wish to save preceded by Dx: where “x” is the 
Drive number to which you wish to have the file saved. Filenames must not exceed 
eight characters in length with an optional three character extender. Please refer to 
your DOS XL Operator's Guide for full details. When saving worksheets to disk be sure 
that you are not writing over a previously saved file of the same name by accident. 
You should also be sure that there will be enough free space on the disk to hold your 
worksheet. 


If you make an error, such as forgetting the “D:" or overloading the disk, the GT 
Albert E. Spreadsheet will respond with the message "INPUT ERROR - REENTER", 
sound the buzzer, and return you to the Command Menu. If this occurs, simply try 
again. 


Using the LOAD Command 


The first step to loading a worksheet from disk into the GT Albert E. Spreadsheet is to 
press the "L" key. Next proceed with the Disk Directory option as described above 
until the following prompt is displayed: 


FORMAT: D:filename.ext 
ENTER FILE TO LOAD: 


Now enter the name of the GT Albert E. Spreadsheet file to LOAD, following the same 
syntax rules explained above for saving files. After you press <RETURN>, the 
specified file will be loaded into your workshect, erasing any information entered 
previously. But it may not LOAD in, under the conditions which are described below. 


Actually the first step to loading in a file is not always to press the “L" key as 
mentioned above! In order for the GT Albert E. Spreadsheet to accept the file from 
disk, the worksheet you are currently working in must be the same size as the one to 
be loaded from disk. In other words, you must have initialized the GT Albert E. 
Spreadsheet (see the section on Choosing Worksheet Size) with the same number of 
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COLUMNS by the same number of ROWS as the worksheet on disk. If you are not sure 
what size the worksheet file on disk is, then attempt to LOAD it in anyway. The GT 
Albert E. Spreadsheet will then inform you of its size like this: 


WRONG SIZE DATA SHEET 
THIS WORKSHEET IS 5 COLUMNS BY 30 ROWS 
ATTEMPTED TO LOAD A 10 BY 37 WORKSHEET 
HIT ANY KEY TO CONTINUE 


Now that you know the dimensions of the worksheet you would like to LOAD in, hit 
any key to return to the Command Menu, then press "Q" to QUIT and "Y" to confirm. 
This will return you to the “Title Screen" and you can now initialize the GT Albert E. 
Spreadsheet to the proper size for loading the desired file. You may then repeat the 
loading steps to bring the worksheet in from disk. 
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PRINTING (Optional) 


If you own a printer for your Atari computer, you will be interested in learning how to 
print out your worksheets for permanent records. The GT Albert E. Spreadsheet will 
print on most 40 column or 80 column printers. It will also print to some 132 
column printers, although the GT Albert E. Spreadsheet will limit you to printing eight 
COLUMNS across. (Please note that the column printing capability of the printer is 
not the same meaning as the "COLUMNS" referred to in the rest of this document.) 


The first step to printing a worksheet is of course to turn on the printer and interface if 
applicable. Next press the "P" key to start the PRINT command. The GT Albert E. 
Spreadsheet will respond with: 


SPECIFY RANGE TO PRINT: 
FROM 

CELL:?— 

UPPER LEFT LOWER RIGHT 


You must now choose the section of your worksheet which you would like to print. 
The only limitation is that a maximum of eight COLUMNS can be printed at one time 
(four COLUMNS on a 40 column printer). Start by entering the upper left cell to be 
printed and press <RETURN>. The display should now look like this: 


SPECIFY RANGE TO PRINT: 
FROM TO 
CELL:?A1- CELL:?—- 


UPPER LEFT LOWER RIGHT 


Now specify the lower right cell to be printed and press <RETURN>. If all is well you 
will soon have a “hard copy" of your GT Albert E. Spreadsheet worksheet. 


If your GT Albert LE. Spreadsheet has any problems communicating with your printer, 
the message "ERROR - CHECK PRINTER" will appear, the buzzer will sound, and the 
program will return to the Command Menu. If this occurs, check all your equipment 
for power, proper cable, etc. and then try again. 
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CLEARING THE WORKSHEET (NEW) 


If at any time during a GT Albert E. Spreadsheet session you would like to clear the 
worksheet and erase all entries, you can use the NEW command. Simply press the "N" 
key. Because this is a serious action, the GT Albert E. Spreadsheet will then ask you 
to confirm your decision like this: 


ERASE WORKSHEET! 
ARE YOU SURE? (Y/N) 


If you are sure then press the "Y" key and the GT Albert E. Spreadsheet will clear the 
worksheet and prepare a NEW page to work with. This NEW page will have the same 
dimensions as the previous page (worksheet). If you change your mind, simply press 
the "N" or any other key and you will be returned to the Command Screen with your 
old worksheet still intact. 


91 


—-—_———— 
Indus GT for Atari GT Albert E. Spreadsheet Manual 
ENDING A GT ALBERT E, SPREADSHEET SESSION (QUIT) 


If you wish to end the session with one worksheet and work on a different model you 
may use the QUIT command. This command will erase all current entries and return you 
to the “Title Screen" where you may choose a different size worksheet. To use the 
QUIT command simply press the "Q" key. Because this also is a serious action, the 
GT Albert E. Spreadsheet will then ask you to confirm your decision like this: 


QUIT GT ALBERT E. SPREADSHEET 
ARE YOU SURE? (Y/N) 


If you are sure then press the "Y" key and the GT Albert E. Spreadsheet will clear the 
worksheet and return you to the “Title Screen". If you change your mind simply press 
the "N” or any other key and you will be returned to the Command Screen with your 
old worksheet still intact. 


When you are completely finished with a GT Albert E. Spreadsheet session and have 
saved all worksheets you wish to maintain, you may end the session by removing the 
diskette and turning off the system. 


HAVE FUN! 
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SAMPLE WORKSHEETS 


A sample family budget spreadsheet is included on your GT Albert E. Spreadsheet 
diskette. This worksheet may be used to track the Projected and actual amounts of your 
income and expenses. The filename of this sample spreadsheet is "PERSBUD.DAT". 
You may now load and alter this worksheet to fit your needs, enter your own VALUES, 
RECALCULATE, and SAVE your new budget on disk. The following is what a printout 
of “PERSBUD.DAT" would look like: 





JAN 83 JAN 83 JAN 83 JAN 83 
PROJECT ACTUAL DIFFER %DIFF 

INCOME 

Salary 1500 1500 0 0 

Commiss 400 176 -224 -0.56 

TOT INC: ~~ 1900 1676 aan -0.11789 

EXPENSES 

Rent 550 550 0 0 

Food 200 223.58 23.58 0.1179 

Auto 150 165 15 0.1 

Medical 50 35 -15 -0.3 

Loan 300 300 0 0 

Electre 60 78 18 0.3 

Gas 45 47 2 0.044444 

TOT EXP: ~ fas ~ 1398.58 ee 0.032162 

DISP INC 545 "277.42 2367.58 -0.49097 


There is a second sample spreadsheet on your GT Albert E. Spreadsheet diskette, called 
“PROFLOSS". This is a profit and loss statement for a small business. By changing 
the VALUE in the January Sales category and then RECALCULATING, you can see how 


the monthly projections will change. The following is a representation of the printout 
of “PROFLOSS": 
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JANUARY FEBRUARY MARCH YTD TOTL 
eeeeeeee e+eeeere eeeeereee eeeeeeee 

REVENUE 
Sales 10000 15000 22500 47500 
C.G.S. 6000 9000 13500 28500 
Margin ~4000 ~~ 6000 "9000 ~~79000 

EXPENSES 
Payroll 3000 3300 3630 9930 
Advert 1000 1100 1200 3300 
Supply 500 600 720 1820 
Deprec 150 150 150 450 
Misc. 1000 1200 1440 3640 
Tot Exp 5650 6350 7140 19140 
PROFIT -1650 -350 1860 -140 
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for Drivers of the Indus GTt™ 
Atari'™ Compatible Diskette Drive 


Adaptation by Keith S. Burgoyne 
This manual was last revised on February 1, 1985 


COPYRIGHT NOTICE 


This manual is Copyright © 1986 by Future Systems of Chatsworth, California. The 
Programs comprising DOS XL as distributed with the Indus GT diskette drives are 
primarily Copyright © 1983 by Optimized Systems Software Incorporated of San Jose, 
California. Some Indus GT DOS XL diskettes may contain programs or enhancements 
which are Copyright © 1986 by Future Systems of Chatsworth, California. 


Reproduction or translation of any part of either this manual or the programs 


comprising DOS XL beyond that permitted by sections 107 and 108 of the United 
States Copyright Act without the permission, in writing, of the copyright owner(s) is 
unlawful. 


The contents of this manual were derived under permission from A Reference Guide for 
Copyright © 1983 by Optimized Systems Software Incorporated 
of San Jose, California. 
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TRADEMARK NOTICES 


The following trademarked names are used in various places within this manual, and 
credit is hereby given: 


INDUS GT is a trademark of Future Systems of Chatsworth, California. 


DOS XL, OS/A+, BASIC XL, ACTION!, BASIC A+, MAC/6S, and C/65 are trademarks 
of Optimized Systems Software Incorporated of San Jose, California. 


Atari, Atari Home Computers, Atari Writer, Atari 810 Disk Drive, Atari 1050 Disk 
Drive, and Atari 850 Interface Module are trademarks of Atari Corporation of 
Sunnyvale, CA. 


PREFACE 


DOS XL and Synchromesh is the result of the efforts of several persons, and we believe 
that proper credit should be given. The original version of the DOS XL Console 
Processor and the original version (“version 2") of the DOS XL File Manager System 
(which is, of course, identical with Atari's DOS 2.0S) were written by Paul Laughton. 
Later version of all other portions of DOS XL are primarily the work of Mark Rose, of 
Optimized Systems Software, with the collaboration of Bill Wilkinson and Mike 
Peters. 


The Synchromesh support enhancements to DOS XL were primarily labored over by 
Greg Farris with assistance from Mark Rose, Bill Wiikinson, and Mike Peters, all of 
Optimized Systems Software under contract from Indus Systems. 


The GTSYNC.COM Synchromesh utility, which includes the Synchromesh extensions 


to the Indus GT drive's control ROMs, as well as the Indus GT's original control ROM 
code were developed by Keith Burgoyne of Indus Systems. 


96 


| 


— 





au 
B 


DOS XL for Indus GT Reference Manual 
DOS XL SERVICE AND SUPPORT POLICIES 


Systems has worked to bring you products which will give you years of reliable 
enjoyment. As with any software product, though, errors or omissions can 

occur. You may rest assured that, if you have a problem, every reasonable effort 
shall be made to help you. 


In order to receive full support, you will need to direct any questions and/or problem 


diskette drives in order to increase the operating system's already extensive 


capabilities. Because of these enhancements, Indus GT users should always contact - 


Future Systems for assistance and never Optimized Systems Software. 


Since DOS XL is only distributed by Future Systems to Indus GT users as a sub-licensed 
product, you must sign and return the Future System's Sub-License Agreement included 
with your DOS XL before we can respond to your inquiries. 


If you have a quick question or simply a procedural problem, you may call the 
Consumer Support staff at Future Systems (818) 407-1647. Full consumer assistance is 
provided between the hours of 9:00 AM to 4:00 PM Pacific Time. 


Although Future Systems attempts to provide the best consumer support possible, 
please understand that many consumer problems can tend to be of a nature which the 
support staff may have never before encountered and may require a little research by our 
staff. Because of this, the person providing you with assistance may not be able to 
answer your questions in a 5-minute telephone call. So, if your problem is such that it 
is not easy to describe, you are invited to mail us a letter and include a diskette or 
computer printout detailing or demonstrating your difficulty. Always remember to 
include your return address, telephone number(s), the hours (for your time zone) you 
can be reached at the various telephone number(s) provided, and also the name and city 
of the Indus GT dealer from whom you purchased your Indus GT(s). In many cases, our 
support staff may wish to contact your dealer should they determine that local 
assistance would be of the best benefit. 
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ABOUT DOS XL AND THIS EDITION OF THE DOS XL MANUAL 


DOS XL is the latest in a series of Disk Operating Systems produced by Optimized 
Systems Software, Inc. 


DOS XL version 2.3 is a direct successor to and completely file compatible with: 


Atari DOS 2.0S 
OS/A+ Version 2.0 
OS/A+ Version 2.1 
DOS XL Version 2.2 


This edition of the DOS XL manual has been issued as what we hope is both a user- 
friendly “manual” to the more commonly used features of the operating system as well 
as a true "reference manual” for the entire DOS XL Disk Operating System. 


What parts of the DOS XL reference manual you read first should depend on your 
experience level and your purposes: 


If you will never program in any language, you may not need to read any more than 
the “Introduction” through "The DOS XL Menu”. 


If you are an Atari BASIC programmer, you should definitely read "Using DOS XL with 
the Atari BASIC Cartridge” as well as Atari's BASIC reference manual before you start 
using DOS XL with Atari BASIC. 


If you are an assembly language programmer, we would suggest reading this entire 
manual, paying special attention to "Using Assembly Language with DOS XL”. 


Finally, if you would like to automate DOS XL, allowing it to do several tasks for you 
while your computer is unattended, you need to read “Controlling DOS XL Without 
Being There”. 


Of course, regardless of your experience level or purposes, if you get tired of the 
restrictions of the DOS XL menu, you should read "Using the DOS XL Command 
Processor”. 


Whatever you choose to do, we hope that this manual and reference manual will help 


you. Written suggestions about these manuals are always helpful and carry much more 
impact than verbal comments. Your letters are always welcome. 
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Section 0: YOUR INDUS GT AND DOS XL 


0.1 How Do You Get Started Using Your Indus GT and.DOS XL? 


It seems that new Indus GT users, whether or not the Indus GT is their first Atari 
diskette drive, always want to do one thing right away: see their new Indus GT operate 
in double density. Although we at Indus Systems would really recommend that every 
new user start with the DOS XL basics in order to get familiar with DOS XL and their 
Indus GT, we hereby submit to the majority's desires and provide, right here in the 
front of this manual, some quick instructions on how to get your Indus GT to operate 
in double density. 


The first step in using double density is to create a double density version of your 
single density DOS XL System Master Diskette which came with your Indus GT. Which 
sections of this manual you need to read in order to do this depends upon your own 
experience level. 


If you have never used any diskette drive or DOS before, you should read all of the 
“Introduction” section. This section will provide you with some background 
information which the rest of this manual will expect you to know. In addition, you 
should read the "Getting Started With DOS XL" section to find out how to get DOS XL 
started on your Atari. 


If you are already familiar with using a non-Atari DOS but not a DOS on the Alari, you 
should read "What About Double Density?”. Even if you are already experienced with 
single and double density on non- Atari DOS's, : 

ity?" i Atari DOS's, in general, do not work with double density like most 
computers’ DOS's. 


All users should read “How Do You Keep Your DOS XL Diskette Safe?". Although our 
consumer support staff is always very nice and polite to any user who calls, you might 
find yourself a little embarrassed calling us because you've accidentally ruined your 
DOS XL System Master Diskette. 


All users should also read "How Do You Make a Double Density DOS XL Diskette?". 
This section explains how to create a diskette which is in double density; but don't 
stop there. Once you have a double density DOS XL system master diskette, you can 
simply boot this diskette and your drive will be operating in double density. 

Once you've followed all the directions in the sections of this manual indicated above, 
you can feel yery confident that your Indus GT is operating in its normal finely-tuned 
stale. 


PROBLEM PREVENTOR: Never use the front panel buttons on your Indus GT to 
select the drive's emulation mode (as described in the Indus GT drive manual) when 
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using DOS XL. There is absolutely no case in which this would be proper. DOS XL 
provides its own commands for changing your Indus GT's emulation mode (or operating 
density), and these commands also notify DOS itself of a density change which the 
Indus GT's front panel switches do not. Also, care must be used when changing 
diskettes in your Indus GT if the change involves two diskettes of different densilics. 
Such a change is permitted, but a density change command must be given to DOS XL 
to notify it of the change. 


PROBLEM PREVENTOR: Note that most of the instructions on how to convert to 
using double density with your Indus GT fall under the major section “Some Advanced 
Capabilities of DOS XL". If you are a new user, please take note of this. Once you've 
had fun running your Indus GT in double density, please go back to the more simpler 
sections of this manual to learn the basics of operating DOS XL before leaping too far 
ahead. Please Jeam to walk before you try to run, 


0.2 What About the Atari 1050's Double Density? 


Your Indus GT does support the Atari 1050 double density diskette format, but DOS XL 
does not. What does this mean? It means that if you have a copy of Atari's DOS 3.0 or 
DOS 2.5, you can use it with your Indus GT in both single and 1050 double density 
modes. DOS XL does not support the 1050's double density format because this formal 
provides only about 1.4 times (40% more) the storage capability of standard single 
density. DOS XL's double density format provides a full 2.0 times (100% more) the 
storage over single density. Whenever this manual refers to double density, it is 
referring to the 2.0 times double density and never the 1.4 times double density. 
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Section 1: INTRODUCTION 


This manual is intended for both the beginning and advanced user of the DOS XL 
operating system. Many of the advanced features of DOS XL which are not required for 
normal usage are discussed in later sections of this manual so as to avoid confusing 
first-time users. In many cases, early sections of this manual will discuss the “simpler 
side” of some of the more advanced features and will then direct you to later 
discussions for the “advanced side” of that particular feature. 


1.1 What is Required to Use DOS XL? 


DOS XL will work equally well on all models of Atari computers, provided the model 
you are using has at least 48K of memory inside. 


1.2 Why Do You Need DOS XL? 


The purpose of DOS -XL is to provide a way for your Atari computer (and you) to 
communicate with your disk drives, printer, and other peripherals. DOS XL contains 
commands and utilities which allow you to: 


1. Organize the information and programs with which you are working into “files”. 
This organizing is similar to the way you would organize information printed on paper 
using file folders and a filing cabinet. 


2. Provide an easy means by which you can access this information whenever needed. 


3. Make use of various pre-written specialized application programs (like word 
processors, spread sheets, and data managers) and programming tools (like higher 
powered BASICs, machine/assembly language processors, and program “debugging” 
aids). 


4. Go from using DOS XL itself, to using a cartridge inserted into your Atari, to using 
any of the thousands of programs sold on diskette, back to using DOS XL itself. 


But, in order for DOS XL to know exactly what you want it to do at any given 
moment, you need to “command” it. And “command” is truly the correct word for how 
you talk (using your Atari's keyboard) to DOS XL. Whatever you command DOS XL to 
do, it will do provided it knows how to do it and provided you have commanded it in a 
way it understands. Remember: DOS XL never actually “thinks” for itself (although 
beginners often find this hard to believe), it only does what you tell it to do regardless 
of whether or not what you told it is actually what you wanted it to do. Explaining to 
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you exactly how to command DOS XL to get it to do your bidding is this manual’s sole 
purpose in life. 


1.3 So What is a (Diskette) "File" Anyway? 


Much like the way a phonograph record or a cassette tape can hold a number of songs, 
a single diskette can hold many distinct files of information (up to 64 files per 
diskette). These files can hold programs or data in text (human readable), binary 
(computer readable), or several other forms. Just like songs on a phonograph record, 
diskette files must have names so that you can tell DOS XL exactly which file you 
wish to use. This is slightly different from that slow and old fashioned method of 
saving files on cassette using one of the Atari Program Recorders, since cassette files 
did not have to be given a name. Often, DOS XL and also this manual will refer to a 
“file name” as “file specification", or simply “filespec". They all essentially mean the 
same thing. "File specification” simply refers to your “specifying a file's name”. 


The rules for creating a file name which DOS XL will understand (a “valid” file name) 
are as follows: 


The file name is divided into two parts: the first part is referred to as the “primary 
name" and the second part is referred to as an “extension”. When you create a new file 
name, you should make the "primary name" section something which will remind you 
exactly what information you have placed into that file. For instance, "CHECKS" 
might refer to a file containing information relating to balancing your checkbook. 
The extension is normally used to indicate the type of format in which the information 
in that file is saved. For instance, "TXT" would refer to a text file containing a letter 
you have written using a word processor. Many specialized applications programs will 
select special "standard" extensions for you. 


The primary name section of the file name can consist of up to eight capital (upper 
case) letters (A-Z, lower case not permitted) or numbers (0-9) arranged in just about any 
order your little heart desires. There is, however, one restriction: the first letter of the 
primary name must be a letter and not a number. The primary name section can be as 
short as one letter, but at least one letter must be used. 


The extension section of the file name can consist of up to three letters or numbers 
arranged in any order, and can even start with a number. The extension is completely 
optional; DOS XL does not require you to specify one if you don't want one. If you do 
use an extension following the name section, always separate the two sections with a 
period (.). For instance, "CHECKS.TXT". 


The following are valid file names: GEORGE, TEMP.ABS, PROGI.SAV, SORT123, 
COPY.COM. The following file names would not be accepted by DOS XL (illegal file 
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names): NAMETOOLONG, TEMP.LONGEXTENSION, INUMBER.1ST, lowercas, NO- 
DASH. 


The computer "hackers" who have been beating on computer keyboards for years have 
a sort of “standard” set of extensions which most people eventually learn sometime 
during their years of computer usage. To save you from waiting these years, here's a 
list of some of the more common extensions: 


BAS for a "SAVE"d BASIC program (MYPROG.BAS) 

LIS for a "LIST’ed BASIC program (MYPROG.LIS) 

COM for a DOS XL command/utility program (COPY.COM) 
EXC for a DOS XL execute file (STARTUP.EXC) 

SYS for a DOS XL system file (DOS.SYS) 


TXT for a wordprocessor or editor text file (LETTER.TXT) 


In some cases, file names must be preceded by a drive specifier which tells DOS XL on 
which drive to search for a particular file. The format of a device specifier is: 


Dn: 
(or) 
D: 


where n is a digit from 1 to 4, depending on how many drives you have: If you just 
specify D:, drive 1 is assumed (this is very useful if you only have one drive). For 
example, D1:MYPROG.BAS tells DOS XL to use the file MYPROG.BAS on drive 1. 
D2:YOURPROG.LIS tells DOS XL to use the file YOURPROG.LIS on drive 2. 
D:MESSAGE.TXT tells DOS XL to use the file MESSAGE.TXT on drive 1. 


Whenever you command DOS XL to do something which causes it to create a new file 
on a diskette, DOS XL adds the name of that file to something called a “directory”. By 
maintaining this directory, DOS XL knows where each file on your diskette is located 
just like your address book or telephone directory tells you where all your friends and 
‘associates are located. Whenever you tell DOS XL you wish to use one of the files on 
your diskette, DOS XL reads through this directory, entry by entry, until it finds the 
entry for the file you requested. 


In many cases, you will not wish to specify to DOS XL one specific file; but rather a 
group of files with similar names. To make this possible, DOS XL allows you to use 
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“wild-card” characters as part of the file name. These wild-card characters will match 
any other letter or number when DOS XL goes searching through a diskette directory to 
find the file you have requested. 


There are two wild-card characters DOS XL will accept. The first one is a question mark 
(2) which will match any single letter or number at the same position as the question 
mark in the file name. For instance, if the files YELL.TXT, BELL.TXT, SELL.BAS, 
PRELL.TXT, and SELF.TXT were listed in a diskette directory, a wild-card file name of 
YELL.TXT would match YELL.TXT and BELL.TXT. 


The second wild-card character is the asterisk or star (*). This character will match a 
group of zero or more characters. As the following example table shows, this wild- 
card character can be used alone or combined with the question mark in order to gain a 
lot of flexibility: 


aesceeee Wild-Card File Names ------- 


Directory *ELL.TXT SEL*.* 7ELL.* *¢ 

YELL.TXT Matches Matches Matches 
BELL.TXT Matches Matches Matches 
SELL.BAS Matches Matches Matches 
PRELL.TXT Matches Matches 
SELF.TXT Matches Matches 
SELFISH.COM Matches Matches 


As you can see, the wild card characters can be used in both the primary file name and 
the extension. It might appear that wild-card characters are used to tell DOS XL to find 
the first file which matches the wild-card file name you gave, but actually these 
characters are much more powerful. Instead of just stopping at the first file DOS XL 
finds which matches the wild-card file name you specified, DOS XL will continue to 
perform whatever command you gave it on any other files it can find on that diskette 
which also match the wild-card file name. This can save you a lot of command typing 
if you wish to command DOS XL to perform the same command on a large collection 
of files. 


For many of the things you can command DOS XL to do it would not make any sense 
to specify more than one specific file, and DOS XL won't accept a wild-card file name 
when you give it these types of commands. The DOS XL menu commands for which it 
will accept wild- card file names are as follows: 


Files on Disk 
Copy Files 
Erase Files 
Protect Files 
Unprotect Files 
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A full discussion of what these commands will cause DOS XL to do is provided later in 
this manual. 


1.4 How Do You Use Your Other Non-Disk Devices? 


All Atari Personal Computers consider everything which you have to attach to your 
computer via a cable (like your Indus GT) to be an "external device" (or “peripheral”). 
This includes your television set or display monitor. It also includes your computer's 
keyboard even though it is obviously a direct part of the computer unit. When 
prompted for a file name by DOS XL, sometimes you can enter the name of one of 
these other devices instead. These other devices are referred to by names consisting of 
a single letter optionally followed by a single digit used to define a specific device 
when more than one of the same kind exist, such as in the case of DI: and D2: for two 
diskette drives. The device name must be followed by a colon. The following is a list 
of device names which DOS XL will recognize: 


C: The Program Recorder. This is a device very similar to a standard audio cassette 
recorder, but which Atari has heavily modified so that your Atari Computer can save 
and load information to/from it. You can use the recorder as either an input (load or 
read) or output (save or write) device, but never as both simultancously. 


D1:-D8: Diskette Drive(s). Unlike the program recorder, diskette drives can be used 
for input and output simultaneously. Since diskette drives can also access any piece of 
information recorded on a diskette directly without having to “rewind” or "fast- 
forward” a tape, you usually also have to specify a file name following the device code 
(D1:-D8:), as previously mentioned, so that DOS XL can tell the diskette drive which 
piece of information to input or output, 


NOTE: If you use D: without a drive number, D1; is assumed. 


E: Screen Editor. The screen editor simulates a very limited text editor/word processor 
using the keyboard as input and the display (television or monitor) as output. This is 
the editor you use when typing in a BASIC program. In many cases, DOS XL, 
BASIC, and many other programs will assume that you want to use this device (E:) 
unless you specify some other device. 


K: Keyboard. This device code allows you to specify just the keyboard half of the full 
screen editor device. This device can be used for input only. 


P: Printer. This device code allows you to send text to your printer if you have one. 
On old Atari computer configurations, output to the P: device was sent to a printer via 
Atari's 850 Interface Module. Atari's newer printers can be connected directly to your 
Atari computer without the added expense of this interface module. 
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R1:-R4: RS-232 Serial Ports. In addition to connecting a printer to an Atari 
computer, Atari's 850 Interface Module also permits your Atari computer to perform 
RS-232 communications. RS-232 is an extremely industry standard type of 
communications which permits just about any computer to talk to just about any other 
computer as well as an extremely large number of non-Atari peripherals like video 
terminals, non-Atari printers, plotters, and modems. These four RS-232 devices can be 
used for both input and output. 


NOTE: If you use R: without a device number, R1: is assumed. 


S: Screen Display (either television or monitor). This device code allows you to 
specify just the screen display half of the screen editor device. Both input and output 
can be performed to/from this device, thus permitting programs to both change the 
screen display and read what the screen is currently displaying. 


1.5 How Does DOS XL Accept Commands? 


A primary feature of DOS XL is the two different ways by which you can command it. 
You may choose either a menu mode or a Command Processor. In case you are 
unfamiliar with other menu driven programs such as Atari's own DOS, a menu is simply 
a list of commands which appear on the screen. You need simply choose one of the 
options listed before you. If additional information is required, you are further 
prompted by the program (DOS XL in this case) to type the necessary information. In 
this way, you need not remember all the special command words which DOS XL will 
; instead, you may simply select a command from the list. 


The other way of commanding DOS XL is under DOS XL’s Command Processor mode. 
In this mode, you are pot shown a list of commands to choose from. Instead, you must 
remember (or look up in this manual) all the command words necessary in order to get 
DOS XL to do your bidding. Although this might at first be cumbersome, once several 
commands have been committed to memory, the command mode is much faster and 
easier to use. Also, certain advanced features of the DOS are available only from the 
Command Processor. Since using DOS XL from under the Command Processor mode is 
obviously for advanced Atari users, a discussion of its operation has been provided in 
the later sections of this manual. 


The copy of DOS XL you have received with your Indus GT is set up so that you will 


be presented with the menu mode of command entry. It is recommended that this mode 
be used exclusively until you have gained a lot of familiarity with DOS XL 
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2.1 How Do You Get DOS XL Running? 


"Getting DOS XL Running” is referred to as “booting” DOS XL. “Booting” refers to 
how every DOS must “pull itself up by its boot straps", which in turn refers to how a 
DOS must essentially get itself running with only a bare minimum of assistance from 
the computer itself. After all, every other program you'll run has some sort of DOS 
(you may not see it) which loads the program into the computer's memory and starts it 
running; but the DOS itself has no one to help it. 


Anyway, here's the step by step approach to booting DOS XL: 


1) Connect your disk drive and any other peripherals to your Atari computer following 
the manufacturer's instructions for each peripheral. 


2) Turn on your peripherals and your monitor or television, but leave your Atari 
computer turned off. Important reminder: Never leave any diskette inside any 
diskette drive when you are turning the drive's power on or off. All drives pass 
through a sort of “undefined” state when they are being granted or deprived of power. 
Very extensive circuitry has been built into your Indus GT to prevent it from altering 
information on your diskettes should they be left in the drive during this “undefined” 
state (after all, you have no control over a power black-out), but it is always safer to 
remove any diskettes first. 


3) Insert the DOS XL diskette which came with your Indus GT into your disk drive 
(drive 1 if you have more than one drive). For both Indus and Atari drives, the label of 
the diskette you want to boot should be facing up and the oval cut which exposes the 
diskette's surface should be inserted first. 


4) For the time being, make sure there are no cartridges inserted into your Atari 
computer (this includes any BASIC cartridge). It will probably be very common for you 
to boot DOS XL with cartridges installed (especially a BASIC cartridge) at a later time, 
but for now you'll want to keep things very simple. 


5) Turn on your Atari computer and the rest is automatic: the disk drive will start doing 
things, and after a time the DOS XL copyright message will appear at the top of the 
screen. Then, a message will begin to appear, line by line, which begins with 
“Welcome to DOS XL...". This message is coming from something called a “start-up 
file”. Getting rid of this start-up file is discussed later in this manual. The last line 
from the start-up file is just "MENU". This is a command which instructs DOS XL to 
load the DOS XL menu. After a few more seconds, the menu program will finish 
loading, the screen will again clear, and the DOS XL menu will appear. 
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2.2 What About Double Density? 


Once you have your DOS XL diskette booted, you will probably start asking yourself 
about the Indus GT's double density capability. But before starting to use double 
density, you will need to understand some differences between using single density 
versus double density. In truth, you will probably find occasion to use both 
densities. There are many various reasons for using one density versus the other, here 
are just a few: 


ity; To be compatible with diskettes created or designed for Atari 810 or 
1050 disk drives, you will need to use single density. Single density diskettes used 
with DOS XL are completely file compatible with Atari DOS 2.0S. All operations 
which work with Atari DOS will generally work with DOS XL when used under single 
density. 


Are there exceptions? Yes. Several companies produce self-booting disks (that is, you 
simply put them in the disk drive and tum on the computer, you don't need DOS XL) 
which make use of certain strange features available only in Atari's own DOS. There is 
nothing we can do to make DOS XL compatible with these disks! On the other hand, 
this is not really a problem, since (as we mentioned) these disks are generally self- 
booting (implying that they include a copy of Atari DOS on their disk). To use these 
diskettes, do nothing special. Simply follow their manufacturers’ directions. 


Double Density; Generally, most programs written with cartridge- based languages will 
work fine with double density DOS XL. This usually includes programs written in Atari 
BASIC, PILOT, LOGO, Optimized Systems Software BASIC XL, MAC/65, ACTION!, 
C/65, and more. Of course, if you yourself have written the program and have not 
made assumptions about the size and type of disk, your programs will run correctly 
also. 


What doesn't work in double density? Programs which assume that sectors always 
contain 128 (or 125) characters. Programs which are self-booting and which have 
special “protection” schemes which prevent you from copying them. Programs which 
try to perform some or all of the diskette drive input or output themselves without 
asking for the DOS's assistance. As mentioned above, though, these programs are 
usually distributed on self-booting disks, so you need do nothing special with them. 


How do you use double density? The first thing you will need to do is create what is 
called a “Double Density System Master Diskette". This diskette is identical to the 
single density one we sent you, except it will be double density and have more storage 
capability. Before you can create this double density diskette, you will need to become 
more familiar with how to command DOS XL. Therefore, creating the Double Density 
System Master is explained later is this manual. 
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SPECIAL NOTE: Under DOS XL, a double density diskette will contain exactly the 
same number of sectors (units of storage) as a single density diskette. This confuses 
many beginning users. The difference between double density and single density under 
DOS XL is the size of the sectors. Double density sectors are twice as large as single 
density sectors, and therefore programs and other data saved on double density 
diskettes require fewer sectors of storage than they require on single density diskettes. 


2.3 How Do You Use The DOS XL Menu? 
When you boot the DOS XL diskette which came with your Indus GT, it will 
_ automatically place you (after it does a lot of other stuff) into the DOS XL menu. This 
menu looks something like this: 


DOS XL MENU version 2.20 


- copyright (c) 1983 OSS, Inc. 
Files on Disk Protect Files 
To Cartridge Unprotect Files 

= Copy Files Rename File 
Duplicate Disk Save Binary 
Erase Files Load Binary 
Initialize Disk Go to Address 

u Xtended Command Quit to DOS XL 


Enter your selection. 


a Although the above sample does not show it, the first characters of each of the 12 
commands in the list are in inverse video (dark characters on a lighted background). 
These characters are those which you would type to select a command. For example, to 
command DOS XL to "Rename File", you would simply type "R", in response to the 
“Enter your selection” prompt. For most of the menu commands, extra input is 
required. The menu will prompt you with appropriate messages whenever you are 
required to input more information, such as a file name. 


Whenever you are prompted by the DOS XL menu to enter a filename or a filespec, you 
don't always have to specify the device name for the drive (D1:-D8:). If you do not 
specify a device name, drive | is assumed (D1:). For example, if you typed "GEORGE" 
as a filename, the menu would assume that you meant "D1:GEORGE". 


PROBLEM PREVENTOR: In general, you may not omit the drive specifier on 
names entered while using cartridge based products such as Atari BASIC or Optimized 
Systems Software BASIC XL. Except when working with the menu or DOS XL's 
Command Processor, you usually need to specify the entire file name (and often must 

= enclose it in quotes, as in Atari BASIC), 
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2.4 Is Your DOS XL Diskette Okay? 


In order to ensure that your DOS XL Master Diskette (the one which came with your 
Indus GT) is } ,00d condition, you should view the names of the files contained on it. 
The DOo XL menu of commands should be visible on the screen, and the menu will 


prompt you with: 
Enter your selection. 


The first command in the menu is "Files on disk". This command allows you to view 
the names of the files on a diskette. First ensure that your DOS XL master diskette is 
still in drive 1. Then command DOS XL to list the names of the files on your diskette 
by pressing the "F" key on your keyboard. 


The DOS XL menu program will respond to this command with: 


Files on disk 
Filespec: 


In order to look at all files on the disk, simply press the <RETURN> key. (Note: 


<RETURN> is used through-out this manual to indicate the key labelled "RETURN" and 
not the individual letters "R", "E", "T", “U", "R", and "N".) 
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The list of files on your master disk will appear and should look something like: 


DOS SYS 053 
DOSXL SYS 046 
MENU COM 025 
CLRDSK COM 023 
COPY COM 075 
DO COM 003 
DUPDBL COM 011 
DUPDSK COM oll 
INIT COM 006 
INITDBL COM 023 
RS232 COM 001 
SDCOPY COM 086 
SYSEQU ASM 022 
MEM Lis 066 
RS232FIX COM 002 
CONFIG BAS 039 
GTRPM COM 045 
VERIFY COM 001 
NOVERIFY COM 001 
GTSYNC COM 027 
STARTUP EXC 003 
RAM130 COM 007 
115 FREE SECTORS 

Hit RETURN for menu 


Each of the files has a primary name and an extension, For example, the file 
COPY.COM has the primary name COPY and the extension COM. Note that in the file 
listing the period is not shown, Instead, there may be one or more spaces between the 
primary name and the extension. This format appears only in the file listing. You 
may never use this form for specifying files. If you are using file extensions, you must 
use a period with no intervening spaces, as in "D:TEST.LIS". File names are explained 
earlier in this manual. 


Notice that all of the files on the master disk except the file "STARTUP.EXC" are 
preceded by an asterisk in the directory listing. An asterisk preceding a file implies 
that it has been protected from modification or erasure through the use of the DOS XL 
menu command “Protect Files". This method can also be used to protect your own files 
from change or deletion through accidental use of one of the DOS XL commands. 
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2.5 How Do You Keep Your DOS XL Diskette Safe? 


Once you have successfully booted your master disk, you will now need to make & 
second (or “backup") copy. This permits you to put your DOS XL master diskette away 
in a safe place and only use the second copy you've made. That way if, for some 
unexplained reason, your second DOS XL diskette gets magnetically altered and will no 
longer boot, you can recreate it from your safely stored-away master diskette. 


First, for safety's sake, place a wrile protect tab over the write- enable notch on your 
DOS XL master disk, if it docs not already have one. This will prevent any mistakes 
you may (or may not) make while using DOS XL from damaging your DOS XL master 
diskette. Note: Some copies of DOS XL may be distributed on diskettes which don't 
even have write-enable notches which need to be covered. In these cases, you won't 
have any notch to cover. Location and usage of the write- enable/protect notch is 
provided in your Indus GT Drive Manual. 


The DOS XL booting process should leave you with the DOS XL menu of commands 
displayed on your screen. The following prompt will appear with the cursor below the 
menu: 


Enter your selection. 


What you do at this point depends upon whether you have one or two (or more) drives. 
If you have two or more drives, and your second drive is an Indus GT, then you'll need 
to read the section later in this manual which discusses configuring your Indus GT. The 
reason for reading this later configuration discussion at this point is because you will 
need to make sure your second drive is configured for single density. Once you've read 
that section, you can resume at this point. If you only have one drive then you won't 
need to be concerned about the configuration discussion. If you have a second drive 
which is not an Indus GT, an Atari 810, or an Atari 1050, then you should consult that 
drive's manual to see if the drive is “configurable”. If it is, you will need to read the 
later discussion at this point. If it isn't, then you can just continue on here. 


In response to the “Enter your selection” prompt, you'll want to type "D" for 
“Duplicate Disk". This will cause the DOS XL menu program to ask you: 


Double density? 


As mentioned before, the DOS XL system master which came with your Indus GT is 
single density; so you'll want to answer this question with “N<RETURN>"” for “No”. 
Later on when you are making other backups you would answer "Y" for “Yes” if the 
diskette you are copying is in double density. 


Either the DUPDSK.COM (short for DUPlicate DiSK) or DUPDBL.COM (short for 


DUPlicate DouBLe density disk) utility program will be read into memory, depending 
on whether you answered "N" or "Y" to the last prompt. The next prompt is: 
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Source disk (1,2,3,4) : 


Normally, you will copy from drive 1 so type "1". The DOS XL menu will the prompt 
you with: 


Destination disk (1,2,3,4) : 


Your answer to this prompt is dependent upon whether you have one or more drives. If 
you only have one drive, then the answer is quite obviously "1". If you have two or 
more drives, then answer with "2" in order to speed up the copying process. Once 
you've entered your answer, you will then be asked: 


Format destination disk (Y/N)? 


Most blank diskettes are unformatted. That is, they are not yet prepared to hold any 
information. In order to copy files or diskettes to blank diskettes, they must first be 
formatted. Therefore, answer this question with "Y<RETURN>" for "Yes". If you know 
that your destination diskette is already formatted, answer "Y<RETURN>" anyway just 
to be consistent. At this point, the DUPDSK or DUPDBL utility will instruct you to 
either: 


Insert source disk into drive 1 
And hit RETURN when ready 


or: 


Insert source disk into drive 1 
Insert destination disk into drive 2 


And hit RETURN when readydepending upon whether you are using one or two drives 
for the copy. 


Your master disk should still be in drive 1 at this point, which is the source diskette 
and drive. If you are using drive 2 for the copy, insert your blank diskette (or a 
diskette to be completely recopied thus losing any old information the diskette may 
have contained) into drive 2. Once you have the correct disk(s) in the correct drive(s), 
press "<RETURN>". 


The busy light on the front of your source disk drive will come on, and the diskette 
duplication utility will respond by saying: 


Reading source disk 
If you are only using one drive for the copy, when the busy light on your drive goes 


out you will be prompted with: 
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Insert destination disk into drive | 
And hit RETURN when ready 


The diskette duplication utility has read as much as possible of the source disk into 
your computer. At this time, remove your DOS XL master disk from drive 1 and insert a 
blank diskette or one which you no longer need the old information on it any longer. 
When the diskette is in, press "<RETURN>". 


The program will respond: 
Formatting destination disk 
and, after a while, 

Writing destination disk 


Most of the time, the total information on a diskette is too large to hold in your 
Atari's memory at one time. This is the case for your DOS XL disk. Therefore, if you 
are only using a single drive to make the copy, you will be prompted to repeatedly 
insert your source and destination disks (the DOS XL master and the blank 
diskette, respectively) until the duplication is complete. Follow these prompts 
carefully until the diskette duplication utility responds: 


Copy same disk again (Y/N)? 


This means you, with DOS XL's help, have successfully created a backup copy of your 
DOS XL master diskette. Remove this backup DOS XL from the drive and place a 
write-protect tab over the diskette write-enable notch. You should also make a label for 
the diskette which indicates that it is your single density DOS XL System Diskette 
("System Master Diskette" refers to the diskette you received with your drive.) 


To get back to the main DOS XL menu, type “N<RETURN>" in response to the above 
question. The disk duplication utility program will respond with: 


Hit RETURN for menu 


After you press "<RETURN>", DOS XL will return you to the main command menu. 


2.6 How Do You Use Cartridge BASIC or Other Cartridges? 


How various cartridges work with DOS XL depends upon which particular cartridge is in 
use. All cartridges will work with DOS XL exactly the way they work with standard 
Atari DOS 2.0S. Certain cartridges, especially game cartridges, are designed not to 
work at all with any DOS. These types of cartridges are written in such a way that your 
Atari computer starts them running the minute the computer is turned on, before the 
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computer attempts to start booting the DOS. Because DOS is never booted, the 
cartridges don't require DOS and therefore there is no "using" DOS XL with these 
cartridges. 


The other main type of cartridge is one which wants to use DOS for saving and loading 
programs, text, or other information. Most of these types of cartridges are 
programming language cartridges such as Atari's BASIC or Optimized Systems 
Software's BASIC XL and ACTION!. These cartridges will permit your DOS XL to be 
booted into the computer, and then the DOS XL will in turn automatically start the 
cartridge running (this is called “transferring control (of the computer) to the 
cartridge"). This means that if you boot DOS XL without Atari's BASIC cartridge in 
your computer, you end up with either the DOS XL menu or at DOS XL command level. 
But, if you boot DOS XL with the BASIC cartridge installed, you end up with BASIC's 
"READY" prompt. 


There is a certain case in which DOS XL will not automatically transfer control to one 
of these cartridges. This is when the booted DOS XL diskette contains a file called 
"STARTUP.EXC". This is a special automatic command file from which DOS XL will 
take its commands when DOS XL is finished booting. The STARTUP.EXC file is an 
advanced feature of DOS XL which is discussed later in this manual. 


The DOS XL diskette which came with your Indus GT contains a STARTUP.EXC file 
which produces a series of single line messages prior to giving you the command 
menu. If the STARTUP.EXC file is "Erased" (the “erase” menu option is discussed later) 
from a copy of your DOS XL diskette (never alter your original DOS XL diskette) then 
those “hello” messages will no longer print and you will be placed directly in the 
command menu. 


Since a STARTUP.EXC file can contain a command which tells DOS XL to transfer 
control to a cartridge, DOS XL will follow the commands in STARTUP.EXC rather than 
automatically giving the cartridge control. Since the STARTUP.EXC file on the 
diskette which came with your Indus GT never tells DOS XL to start the cartridge 
running, that copy of DOS XL will never automatically leave you in BASIC or any 
other cartridge. If you erase the STARTUP.EXC file, then DOS XL will automatically 
give control to any cartridge present (if the cartridge wishes control). 


You can always tell DOS XL to transfer control to a cartridge by specifying the "To 
Cartridge” command on the DOS XL command menu. This command is discussed later. 
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Section 3: THE DOS XL MENU 


The DOS XL menu was designed to be easy to use while allowing you access to the full 
power of both your Indus GT diskette drive and your Atari computer. 


For those of you who have previously used Atari DOS, here is a summary of the 
differences between the DOS XL menu and the Atari DOS menu: 


1) Loading the DOS menu - The Atari DOS menu must be loaded in from the disk 
whenever you retum to DOS from a cartridge. Since we felt that this process was too 
slow and cumbersome, we made sure that the DOS XL menu may be kept “resident” (in 
memory) at all times. This does occupy about 2,000 characters more memory, but this 
is more than offset by the extra ease-of-use. Once you become comfortable with DOS 
XL, you can then begin to learn how to issue commands directly to DOS XL without 
using the menu program; thereby freeing up these 2,000 characters of storage for other 
uses. 


2) Atari DOS supports the use of a special file in which to save user memory while 
accessing DOS functions (the MEM.SAV file). DOS XL neither supports nor needs this 
file. 


3) The DOS XL menu only requires you to press a single key lo access commands, 
whereas Atari DOS insists that you keep pressing the “<RETURN>" key after cach 
menu selection. 


3.1 What is the DOS XL Menu? 


Whenever the menu is entered, the following list of commands will appear on the 
screen: 


DOS XL MENU version 2.20 
copyright (c) 1983 OSS, Inc. 


Files on Disk Protect Files 
To Cartridge Unprotect Files 
Copy Files Rename File 
Duplicate Disk Save Binary 
Erase Files Load Binary 
Initialize Disk Go to Address 
Xtended Command Quit to DOS XL 


When the DOS XL menu is visible on the screen, you are prompted with: 
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Enter your selection. 


At that point, you should type the first letter of any of the DOS XL menu commands 
listed on the screen. If more input is required to complete the command, the menu will 
prompt you for more information. Unless the command loads a utility program, you 
may cancel a command at any time by hitting the [ESCape] key on the upper left of 
your keyboard. If the command loads a utility program (the only commands which do 
this are “Copy Files", “Duplicate Disk", and “Initialize Disk"), you may have to press 
the [RESET] key in order to cancel the command. 


The following sections describe each menu command in detail. The commands are 
presented in alphabetical order, not the order in which they appear in the menu. 


3.2 How Do You "Copy Files" From the Menu? 


The “Copy Files" command menu item allows you to transfer files between diskettes or 
to different files on the same diskette. This command is most useful for copying one or 
a few files from one diskette to another. If you desire to transfer all or most of the 
files on a single diskette to another diskette, you should use the "Duplicate Disk" 
command menu item instead, as it will perform the operation much more rapidly. 


To use the copy command, select "C" when the menu prompts you for a command 
selection. At that time, DOS XL will check for the COPY.COM file on the diskette in 
drive 1. This is the utility program which performs file transfers. If DOS XL does not 
find the COPY.COM program, you will be prompted to insert your DOS XL master 
disk as follows: 


Copy Files 
Insert MASTER disk and hit RETURN 


If you receive this prompt, take out any disk in drive 1 and insert any DOS XL system 
disk which is in the same density as the diskette which was in drive 1 and press the 
<RETURN> key. 


The menu will then prompt: 


Copy Files 
From file: 


At this point, you should respond with a filespec specifying the file or files to be 
copied (¢.g., D:GEORGE, D2:JUNK.LIS, etc.). For example, if you want to transfer the 
contents of the file "PROG" on drive 1 to another diskette, you should type 
"D1:PROGI". 
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Notice that wild-cards may be used to refer to files using the COPY utility (e.g., 
TEMP.*, AB??.COM, etc.). As a special case, if you wish to copy all files on a disk to 


another disk, just use a filespec of Dn:, where n is the source drive number (e.g., D1:). 
How to use wild-cards is discussed earlier in this manual. 


The COPY utility will then prompt: 

To file: 

You should respond with the destination filespec. In most cases you will want to 
transfer files from one diskette to another without changing their names. In this case 
you may refer to the destination filespec as just Dn:, where n is the destination drive 
number (e.g., D:, D1:, D2:). In the above example, if you wanted to copy "PROG1" to 
a different diskette and you own only 1 drive, you should type “D1:". 

You will then be asked: 

Single Drive? 


If you own only a single drive as in the above example, or if you are performing this 
copy to another diskette in the same drive, 


You type: Y<RETURN> 
In any other case, 
You type: NcRETURN> 


The COPY.COM utility program will then be loaded from the diskette, and you will be 
prompted: 


Insert disk(s) to be copied 
and hit RETURN when ready 


Make sure the diskette containing the file you are copying is in the drive you told the 
copy utility it would be in. If you are using more than one drive to make the copy, 
insert your destination disk into the proper drive also. 

You type: <RETURN> 

Before each file is copied, you will be asked: 

Copy 


Dn:filename 
to Dn:filename? 


is 


DOS XL for Indus GT Reference Manual 
If you wish to copy that particular file, 

You type: Y<RETURN> 

Otherwise, 

You type: N<cRETURN> 


If you choose not to copy a file, a message will be printed to the screen verifying that 
the file was not copied. 


Whenever you do choose to copy a file, the source file will be read into memory. If 
you are copying to another disk on the same drive, you will then be prompted to insert 
the destination disk as follows: 

Insert ‘to’ disk and hit RETURN 

If the destination file already exists, you will be asked: 


‘To’ file already exists 
OK to overwrite? 


If you wish to replace the old file with the source file, 
You type: Y<RETURN> 

Otherwise, 

You type: NcRETURN> 


If the destination file has previously been guarded against modification by using the 
DOS XL menu "Protect Files" command (i.e., the file is preceded by an asterisk in the 
“Files on Disk” listing of the disk), the COPY utility program will not be able to 
overwrite that file. The protection must first be removed using the “Unprotect Files” 
menu item before any writes to that file may occur! 


The COPY utility reads as much as possible of the source file into memory at one time. 
If the source file is too large to fit into memory and you are copying on a single drive, 
you will again be prompted: 


Insert ‘from’ disk and hit RETURN 


Re-insert your source disk and continue to carefully follow the directions of the 
prompts until the entire file is copied. 

When a file has been completely copied, a verification message will be printed on the 
screen. When all files have been copied, you will be prompted: 
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Hit RETURN for menu 
To return to the list of menu commands, 
You type: <RETURN> 


PROBLEM PREVENTOR: The “Copy Files” command should not be used to copy 
from single to double density diskettes if you own only | disk drive, Copying between 


two different densities using only one drive is discussed as a special case later in this 
manual. 


PROBLEM PREVENTOR: The “Copy Files" options should never be used to copy 
the file "DOS.SYS” onto another diskette. DOS.SYS is a special file which is handled 
in a very special way by DOS XL (in order to remain fully compatible with Atari's own 
DOS). Because of this special handling, using “Copy Files” to copy DOS.SYS will 
result in the "to" DOS.SYS file containing two copies of the DOS.SYS file; and in 
many cases the “to” diskette will be unbootable. Only the “Initialize Disk" option 
should be used to place a copy of DOS.SYS onto a diskette. After DOS SYS has been 
placed onto a diskette using "Initialize Disk", an “all files" copy can then be 
performed (by specifying the “*.*" file name). Since you will already have placed 
DOS.SYS on the “to” diskette, “Copy Files” will ask if it is “OK to overwrite?” the 
DOS.SYS file. Simply answer “N" for “no”, and “Copy Files” will move on to 
copying the other files. 


PROBLEM PREVENTOR: When using “Copy Files" with only a single drive, it 
will not bother to ask you to “Insert ‘from’ disk and hit RETURN" if you answered an 
"OK to overwrite?" question with "N" for "no". Therefore, always remember to insert 
your “from” disk before answering this question with “N". “Copy Files” will remember 
to ask you to “Insert ‘from’ disk and hit RETURN” after it is done copying the file if 
you answered “OK to overwrite?” with "Y" for *yen". 


3.3 How Do You "Duplicate (a) Disk" From the Menu? 


The "Duplicate Disk" menu item allows you to quickly copy the entire contents of a 
diskette to another diskette. If you wish to copy only one or just a few files from one 
diskette to another, or j j i 
wish to copy to, the "Copy Files” menu item should be used instead. 


PROBLEM PREVENTOR: The “Duplicate Disk" menu item wriles entirely new 
information to the destination diskette, thus completely erasing all files which 
previously existed there. Carefully select the desired destination diskette to avoid 
accidentally destroying your program disks. 
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To select the "Duplicate Disk” menu item, type "D" when you are prompted to enter a 
command selection. 


You will then be asked: 


Duplicate Disk 
Double density? 


If your source disk was formatted under single density, 

You type: NcRETURN> 

If the source disk is double density, 

You type: YcRETURN> 

After you answer this question, DOS XL will check for the DUPDSK.COM (for single 
density) or DUPDBL.COM (for double density) file on the diskette in drive 1. This is 
the utility program which performs full diskette duplication. If DOS XL does not find 
the utility program it needs, you will be prompted to insert your DOS XL master disk 


as follows: 


Duplicate Disk 
Insert MASTER disk and hit RETURN 


If you receive this prompt, take out any disk in drive 1 and insert any DOS XL system 
disk which is in the same density as the diskette which was in drive 1 and press the 
<RETURN> key. 

Once loaded, the diskette duplication utility will prompt you with: 

Source disk (1,2,3,4) : 


Normally, you will copy from drive 1 so, 


You type: 1<RETURN> 
Next you will be prompted with: 


Destination disk (1,2,3,4) : 
If you have only a single drive, or you wish to use drive 1 as your destination drive, 
You type: 1<RETURN> 


If you wish to use a drive other than 1 for a destination drive, 
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You type: n<RETURN> 

where “n" is the number of the desired destination drive. 

Once you've specified the destination drive, you will be asked: 

Format destination disk (Y/N)? 

Most blank diskettes are unformatted. That is, they are not yet prepared to hold disk 
files. In order to copy files or diskettes to blank diskettes, they must first be 
formatted. Therefore, 

You type: Y<RETURN> 


At this point, the disk duplication utility will instruct you to cither: 


Insert source disk into drive 1 
And hit RETURN when ready 


or: 

Insert source disk into drive | 
Insert destination disk into drive n 
And hit RETURN when ready 


In cither case, follow the directions given by the utility. Once you have the diskette(s) 
inserted, 


You type: <RETURN> 


At this point, the light on the front of your disk drive will come on, and the disk 
duplication utility will respond by saying: 


Reading source disk 
If the destination drive is the same as the source drive, you will be prompted: 


Insert destination disk into drive n 
And hit RETURN when ready 


At this time, remove your source diskette from drive | and insert a blank diskette. 


When this has been done, 
You type: <RETURN> 
The program will respond: 
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Formatting destination disk 

and, after a while, 

Writing destination disk 

Most of the time, the total information on a diskette is too large to hold in your 
Atari's memory at one time. This is the case for your DOS XL disk. Therefore, you 
will be prompted to repeatedly insert your source and destination disks until the 
duplication is complete. Follow these prompts carefully until the disk duplication 
utility responds: 

Copy same disk again (Y/N)? 

You type: N<cRETURN> 

At this point, you will be prompted: 

Hit RETURN for menu 

To return to the DOS XL menu, 


You type: <RETURN> 


3.4 How Do You "Erase Files" From the Menu? 


The “Erase Files" menu item allows you to delete one or more files from a diskette. 
This menu item should be used with care since only very advanced users can recover an 
erased file (if at all). 


If you use the “Erase Files" menu item to attempt to erase a file which has previously 
been protected (i.c., the file name is preceded by an asterisk in the directory listing), 
you will be given the error message "FILE PROTECTED”. If you desire to erase this 
file, you must first remove the protection by using the “Unprotect Files" command. 
Note that protecting files is an excellent way of guarding against accidental erasure. 


To use this command, select "E" when the menu prompts you for a command selection. 
The menu will then prompt: 


Erase Files 
Filespec to erase: 


You should respond with the name of the file you wish to erase. If you wish to erase a 
group of files, you may use wild-card characters in the filespec. However, be very sure 
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you know what you are erasing. Wild-card characters are discussed earlier in this 
manual. 


You wil! then be asked: 

Are you sure? 

If you feel the filespec you entered was correct, 
You type: Y<RETURN> 

If you wish to abort the “Erase Files” command, 
You type: NcRETURN> 


If you answered "Y", all files which match the selected filespec will be removed from 
the diskette. The menu will then prompt: 


Hit RETURN for menu 
To return to the menu of commands, 


You type: <RETURN> 


3.5 How Do You List The "Files On (a) Disk" From the Menu? 


The “Files on Disk” menu item allows you to view the names of any or all files on a 
diskette. 


To use this command simply select "F" when prompted by the menu for a command 
selection. Then insert the desired diskette into one of your disk drives (or drive 1 if 
you have only one drive), At that point, the menu will prompt: 


Files on disk 
Filespec: 
The requested filespec instructs DOS XL which files on the disk to look for and 


display. The following table gives some examples of filespecs and the corresponding 
lists of files they display: 
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Filespec Files listed 


GEORGE The file having the name GEORGE, if such a file exists. 

JUNK.SAV The file having the primary name JUNK and the extender SAV, if 
such a file exists. 

AB? Any file not having an extender whose name is three characters long 
where the first two are AB. This filespec matches ABC, ABX, ABI, 
etc. 

CAT* Any file whose name begins with CAT. The filespec matches CAT, 
CATCHER, CATTLE, etc. 

JOHN.??X Any file whose primary name is JOHN and whose extender is three 
characters long ending in X. This matches JOHN.ABX, JOHN.XXX, 
etc. 

+¢ All files on the diskette. This filespec may be abbreviated by just 
<RETURN>. 

Di: All files on the diskette in drive 1. 

D2: All files on the diskette in drive 2. 


NOTE: After entering the filespec you desire, you can optionally enter a space and 
request an “output" specifier -- similar to the intrinsic command processor level 
DiRectory command discussed later in this manual. For instance, entering: 


Files on disk 
Filespec: ve) Cag 


would result in a directory of all of the files on drive one being sent to your printer. 
After entering the filespec, press <RETURN>. DOS XL will then give you a listing of 
all the files on the diskette which match your filespec. If an asterisk (*) prints in front 
of the file name on the listing, then the file is protected from being erased or altered. 
The number following the file name is the number of sectors on the diskette which the 
file occupies. A sector can contain about 125 characters in Single density, and about 
253 in double density. 

Following this listing, you will get: 

Hit RETURN for menu 


So, just type <RETURN> to return to the menu. 
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3.6 How Do You “Go to (an) Address" From the Menu? 


The menu item "Go to Address” is normally only used by very advanced Atari users. It 
allows you to command DOS XL to pass control of your computer to a machine 
language program already residing in your Atari computer's memory. This program 
should have previously been loaded into memory using the DOS XL menu “Load File” 
command, or an equivalent method. 


To use the "Go to Address" command, type ‘G' when the menu prompt “Enter your 
Selection.” appears. At that time, the menu will prompt: 


Go to Address 
Address: 


You should respond with the hexadecimal address of the location in memory to which 
DOS XL is to transfer control (to which it is to jump). For example, if a machine 
language program resides at location $5000 (the dollar sign indicates hexadecimal), 
you would respond with "5000". Note that although the number is a hexadecimal value, 
you should not precede it with a dollar sign when you enter it. 


Be sure that the address you enter is correct; for, in general, if you pass control to a 
location in memory which does not contain the desired machine language program, 
control of your computer will be lost and the keyboard will “hang” (not respond to 
you). In some cases, hitting the [RESET] key on your computer's keyboard will retum 
control to you. Most of the time, however, you will be forced to turn off the power to 
your computer and repeat the boot process. 


Once you press <RETURN> following the address, contro] will be passed to the 
machine language routine located at the desired address. If that routine returns to the 
menu with a 6502 RTS instruction, you will be instructed to: 

Hit RETURN for menu 

To return to the menu of commands, 

You type: <RETURN> 

NOTE: This menu item is strictly for very advanced Atari users. If you don't 


understand some of the terms and procedures discussed for using it, don't worry. That 
probably just means you don't have any need to use it. 
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3.7 How Do You "Initialize (a) _— From the Menu? 


The “Initialize Disk" command allows | you to format blank diskettes so that you may 
use them to store program and data files. If you wish to create a bootable diskette 
rather than just a data diskette, you will normally want to duplicate your DOS XL 
master disk. In this case you should use the “Duplicate Disk" command rather than the 
"Initialize Disk" command. If you want to duplicate any of your diskettes using the 
"Duplicate Disk” command, you do not need to format them first using the "Initialize 
Disk" command, for the “Duplicate Disk" utility will perform the format operation if 
you desire. 


PROBLEM PREVENTOR: The “Initialize Disk” command writes entirely new 
information to the desired diskette, thus erasing completely all files which previously 
existed there. Carefully select the diskette to initialize to avoid accidentally destroying 
your program disks. 


To use this command, select “I" when prompted for a command selection. At that 
point, DOS XL will check for the presence of the INIT.COM utility on the diskette in 
drive 1. If it is not there, you will be prompted: 


Initiallze Disk 
Insert MASTER disk and hit RETURN 


after which you should insert a DOS XL system disk which is of the same density as 
the diskette you remove from drive 1. Then hit the <RETURN> key. 


The INIT utility program will be loaded into memory and you will be presented with 
the four options of the INIT program. They are: 


1. Format disk only 

2. Format disk and write DOS.SYS 
3. Write DOS.SYS only 

4. Reformat boot tracks only 

5. Exit to DOS XL 


PROBLEM PREVENTOR: The "I" (INIT) option may normally be used only to 
initialize diskettes of the same density as the operating density of the drive used for 
the initialization. 


PROBLEM PREVENTOR: Normally, you should use the "Duplicate Disk" command 
to copy your DOS XL master to create a spare bootable disk. However, option 2 of the 
“Initialize Disk" command may be used to create a bootable disk. Do not, however, use 
option 2 if you have booted the system with an Optimized Systems Software 
SuperCartridge inserted. In that configuration, DOS XL will not properly write the 
DOS.SYS file. In order to use option 2 of the “Initialize Disk" command, first remove 
the SuperCartridge and then reboot the system. After using option 2 wo create a 
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bootable disk, the DOSXL.SYS file should be copied onto that disk if it is to be used 
with a SuperCartridge. 


PROBLEM PREVENTOR: You must not be using an extended memory copy of 
DOS XL while initializing new diskettes. You must use the standard version of DOS 
XL. (See discussion of the DOSXL.XL and DOSXL.SUP files elsewhere in this manual.) 
If you are using the OSS Supercartridge version of DOS XL (DOSXL.XL), then all you 
need to do is power off your computer, remove any Supercartridge, and then power your 
computer back on to reboot the standard DOS XL version. If you have a 64K Atari 
computer ("XL" series computer) and have renamed DOSXL.XL to DOSXL.SYS in order 
to use the extended memory, you must rename DOSXL.SYS to some other name 
(normally just DOSXL without the SYS extension), and then tum you computer off and 
then on again to reboot the standard DOS XL version. (Note: extended memory DOS 
XL users who use the DOSXL.XL copy of DOS may find it easier to simply keep some 
DOS system diskettes laying around which are not set up to use the extended memory, 
that way you can simply boot these diskettes instead of always renaming DOSXL.SYS 
to something else.) 


PROBLEM PREVENTOR: When you use option 2 of the initialization menu, the 
copy of DOS XL which will be written to your newly initialized diskette will expect to 
find the menu program (MENU.COM) when the new diskette is booted. But, the 
initialization utility docs not place MENU.COM on your newly initialized diskette for 
you. In order to boot this new diskette, you must first use the "Copy Files” command 
menu item to copy MENU.COM from one of your DOS XL system diskettes onto your 
newly initialized diskette. If you forget to do this, the new DOS XL diskette will start 
to boot but will “die” (stop working) before it says anything on the screen. 


PROBLEM PREVENTOR: Option 4 of the initialization menu has to do with 
special formatting required for optimum performance under synchromesh. Specifying 
option 4 will destroy any existing data on your diskette. Refer to Section 14 of this 
manual for a complete discussion of synchromesh and its initialization requirements. 

If you wish to create a bootable disk, 

You type: 2<RETURN> 

If you wish to create just a data disk, 

You type: 1<RETURN> 

Once you've selected your initialization option, you will be asked: 

Drive (1,2,3,4): 


You should respond with the desired drive number (always 1, if you have only onc 
drive), followed by <RETURN>. 
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‘After selecting the drive to use for the initialization, you will be asked: 
Option n drive n - Are you sure (Y/N)? 

If you are happy with your entries so far, 

You type: Y<RETURN> 

Otherwise, 

You type: NcRETURN> 


If you typed "Y", the specified command will be executed. Once the initialization is 
completed, the initialization utility will prompt you with: 


HIT RETURN FOR NEW FUNCTION 

Once you press <RETURN», you will again be presented with the four options. 
If you have more disks to initialize, repeat the above steps. Otherwise, 

You type: S<RETURN> 

and you will be returned to the DOS XL menu. 


3.8 How Do You “Load (a) Binary" File From the Menu? 


The “Load Binary” menu item allows you to read a binary file from disk into the 
memory of your Atari computer. This command can be used to load binary object of 
assembly language programs, or binary data to be used by such programs. The file you 
wish to load should have previously been written to disk using the DOS XL menu 
“Save File” command, or an equivalent method. 


PROBLEM PREVENTOR: Do pot use this command to load Atari BASIC or BASIC 
XL programs into memory. Instead, just use the LOAD command from the BASIC 
cartridge (i.e., after you have been given the "READY" prompt). 


To use the “Load Binary" command, type “L" when prompted to enter your command 
selection. The menu will then prompt: 


Load Binary 
Filename: 
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You should respond with the name of the previously saved file you wish to load. For 
example, if you wish to load into memory the file "FILE1,OBJ" on drive 1, you should 
type “D:FILE1.OBJ". 


Al this point, DOS XL will access the disk to read in the binary file. You will then be 
asked: 


Hit RETURN for menu 

To return to the DOS XL menu of commands, 

You type: <RETURN> 

NOTE: This menu item is intended for the very advanced Atari user. If you don't fully 


understand this discussion, don’t worry about it. That probably just means you have no 
need to use this menu item. 


3.9 How Do You "Protect Files" From the Menu? 


In many cases you will have created files on your disks which you know you will 
hardly ever need to modify. There is a way to guard these files so that you need not 
worry about accidentally deleting or modifying their contents. The “Protect Files" 
command allows you to protcct files from renaming, erasure, or modification. These 
files will then be preceded by an asterisk in a directory listing when you usc the “Files 
on Disk" command. If in the future you desire to remove the protection afforded by 
this command, you should use the “Unprotect Files" command. 


To use this command, select "P" when the menu prompts you for a command selection. 
The menu will then prompt: 


Protect Files 

Filespee to protect: 

You should respond with the name’ of the file you wish to protect. If you wish to 
protect a group of files, you may use wild-card characters in the filespec. Wild-card 
characters are discussed earlier in this manual. 


At this point the disk will be accessed and the files will be protected. The menu will 
then prompt: 


Hit RETURN for menu 
To return to the menu of commands, 
You type: <RETURN> 
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3.10 How Do You "Quit to DOS XL" Command Level From the Menu? 


The “Quit to DOS XL" command is used to pass control from the DOS XL menu to the 
DOS XL Command Processor. Although almost all the functions you need from DOS 
| L may be accomplished from the DOS XL menu, certain advanced commands and features 
are accessible only from the Command Processor mode. 


To use this command, type "Q" when prompted by the menu to enter a command 
selection. At that point, control will be transferred to the Command Processor mode. 
In place of the menu, the prompt "D1;" will appear at the upper left corner of the 
screen. A short discussion of Command Processor mode (or command level) is provided 
later in this manual. 


3.11 How Do You "Rename (a) File" From the Menu? 


The “Rename File" command may be used to change the file name associated with a file 
of information. This command does not alter or delete any information contained in 
the file. Rather, the file will only show up with a different name in the directory 
listing when using the "Files on Disk" command. 


PROBLEM PREVENTOR: If you attempt to rename a file which has been protected 
against modification (i.c., the file name is preceded by an asterisk in the directory 
listing), you will be given the error message "FILE PROTECTED". If you desire to 
rename this file, you must first remove the protection by using the DOS XL menu 
command, “Unprotect Files”. 


To use the “Rename File” menu item, select "R" when the menu prompt, "Enter your 


L 
L 
Lt 
| " selection.” appears. You will then be asked: 
L 
L 
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Rename File 
Old name: 


You should respond with the current name of the file who's name you wish to change. 
For example, if you want to change the name of the file “D:GEORGE" to "D:PROGI", 
you should type "D:GEORGE". 

The menu will then respond, 

New name: 


At this point you should type the new name you wish the file to have. In the above 
example, you should type "PROG1" at this time. Notice that you must pot use a device 
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specifier (i.e., D:, D2:, etc.) in the new name; you should type just “PROGI", not 
"D:PROG1". 


You will then be asked, 

Are you sure? 

If you are satisfied that you have entered both file names correctly, 
You type: Y<RETURN> 

If instead you wish to abort the rename operation, 

You type: NcRETURN> 


If you answered with "Y", the designated file will be renamed, and you will be 
prompted: 


Hit RETURN for menu 
To return to the list of menu commands, 


You type: <RETURN> 


3.12 How Do You "Save (a) Binary File" From the Menu? 


The “Save Binary" command allows you to write a portion of your Atari computer's 
memory to a disk file. This command can be used to save to disk binary object of 
assembly language programs, or binary data to be used by such programs. 


PROBLEM PREVENTOR: Do not use this command to save Atari BASIC or BASIC 
XL programs from memory. Instead, just use the SAVE command from the BASIC 
cartridge (i.¢., after you have been given the "READY™ prompt). 


PROBLEM PREVENTOR: If you attempt to save binary data to a file which has 
been protected against modification (i.c., the file name is preceded by an asterisk in 
the directory listing), you will be given the error message "FILE PROTECTED". If you 
desire to rename this file, you must first remove the protection by using the DOS XL 
menu command, "Unprotect Files". 


To use the "Save Binary" command, type “S" when prompted to enter your command 
selection. The menu will then prompt: 


Save Binary 
Filename: 
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You should respond with the name you wish the saved file to have. For example, if you 
wish to write memory from locations $4000 to $4100 (the dollar signs indicate 
ee to the file “FILE1.OBJ" on drive 1, you should type 
"D:FILE1.OBJ". 


It is recommended that binary object file names have either the extension "OBJ", or 
"COM". In the former case, "OBJ" would indicate that the file was an assembly 
language OBJect file for a program or data. The second extension, "COM", indicates 
that the program is a system utility program which was either included with your DOS 
XL master disk or written by you or another user. 

Once you've specified the file mame and press <RETURN>, you will be prompted with: 
Starting address: 

You should respond with the hexadecimal value of the first address you wish to write to 
disk. In the above example, the starting address was $4000 so you should type 
"4000". Note that although the value is hexadecimal, you should not precede the 
number with a dollar sign. 

The menu will then prompt with: 

Ending address: 


You should respond with the hexadecimal value of the last address you wish to save. 
In the previous example, you should enter "4100". 


At this point, DOS XL will access the disk to write out the binary file. You will then 
be instructed to: 


Hit RETURN for menu 

To return to the DOS XL menu of commands, 

You type: <RETURN> 

NOTE: This menu item is intended for use by very advanced Atari users. If you don't 
understand parts of the discussion of this menu item don't worry. Chances are you 
won't need to use this menu item anyway. 

3.13 How Do You Go "To (a) Cartridge" From DOS XL? 


The menu item “To Cartridge” yey to instruct DOS XL to start running (transfer 
control to) an installed cartridge. (BASIC, for instance.) 


To use this command, select "T" when prompted by the menu for a command selection. 
At that time, DOS XL will transfer control to any cartridge you have installed in your 
Atari. If the installed cartridge is Atari BASIC, you will then see BASIC's "READY" 
prompt. If you are using some other cartridge, you should see whatever prompt that 
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cartridge produces. If no cartridge was inserted, the error message "NO CARTRIDGE" 
will be displayed. 


If the "To Cartridge” command is used after any of the following commands are 
selected; 


Copy Files 
Duplicate Diskette 
Initialize Diskette 
Xtended Command 
Load Binary 


a coldstart will be performed by the cartridge, thus erasing any program which was in 
memory. Therefore, if you wish to go to the menu to execute any of these commands, 
remember to first write any program you are working on to disk. This is accomplished 
in Atari BASIC or Optimized Systems Software's BASIC XL by using the SAVE 
command in the BASIC cartridge. 


3.14 How Do You “Unprotect Files" From the Menu? 


The “Unprotect Files” menu item removes the protection status placed on a file by the 
"Protect Files” menu item. This in turn allows these files be renamed, erased, or 
modified. These files will no longer then be preceded by an asterisk in a directory 
listing when you use the “Files on Disk" command. . 


To use this command, select "U" when the menu prompts you for a command selection. 
The ment will then prompt with: 


Unprotect Files 
_ Filespec to unprotect: 

You should respond with the name of the file you wish to unprotect. If you wish to 
unprotect a group of files, you may use wild-card characters in the filespec. Wild-card 
characters are discussed earlier in this manual. 


At this point the disk will be accessed and the files will be unprotected. The menu will 
then prompt with: 


Hit RETURN for menu 
To return to the menu of commands, 


You type: <RETURN> 


3.15 How Do You Perform An “Extended Command" From the Menu? 
This command may be used to pass a command line to the DOS XL Command 


Processor. Although almost all the functions you need from DOS may be accomplished 
from the DOS XL menu, certain advanced commands and features are accessible only 
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from the Command Processor mode. The “Xtended Command” function of the 
DOS XL menu may be used to access from the menu those commands available only 
from the Command Processor. The Command Processor’s commands are bricfly 
discussed later in this manual. 


To use the "Xtended Command” function, select "X" when prompted by the menu "Enter 
your selection.”. At that time, the menu will prompt with: 


Xtended Command 
Command: 


You should respond with the DOS XL command you wish to have executed. For 
example, if you wish to use the "RS232" command, you should type "RS232". 


PROBLEM PREVENTOR: Many of the DOS XL commands accessible by the 
“Xtended Command" function rcs their operations by loading utility programs 
from a DOS XL system disk. If you wish to use a command which employs a utility 


program (one of the ".COM" files on a DOS XL system diskette), you should insure 
that a DOS XL system disk is first inserted into drive 1. 


Once you press <RETURN> after entering the extended command, the desired command 
will be passed to the DOS XL Command Processor and executed. When the command is 
finished executing, the menu will prompt you with: 

Hit RETURN for menu 

To return to the DOS XL menu of commands, 

You type: <RETURN> 


PROBLEM PREVENTOR: The following commands should pot be used from the 
menu via the "X" command: 


CONFIG SDCOPY INITDBL 
These commands alter the oy! selection(s) for the disk drives and thus alter the 


amount of memory used for disk buffers. To be safe, always use them only from the 
Command Processor Level. 
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Section 4: THE DOS XL COMMAND PROCESSOR 


4.1 Where Does The "Quit To DOS XL" Menu Item Leave You? 


The DOS XL menu program is actually just a very special utility program which has 
been added to the DOS XL operating system itself. DOS XL normally likes to accept 
the commands you give it through its “Command Processor". This is a very fancy 
name for a piece of DOS XL which interprets the English-like commands you type into 
some action which DOS XL is to perform for you. 


The menu utility program is really nothing more than a helper for the beginning DOS 
XL user. All it does is translate the little single letter menu selection you make into 
the harder to remember English-like commands, and then sends these commands to the 
DOS XL Command Processor for the commands to be acted upon. 


When you specify “Quit to DOS XL” when using the DOS XL command menu program, 
the menu program essentially just stops running by transferring contro! of your Atari 
directly to the DOS XL Command Processor. When you are using the Command 
Processor rather than the menu, you are said to be at “Command Level”. You can 
always tell when you are talking (using your Atari keyboard) to the DOS XL Command 
Processor, because the Command Processor will prompt you with: 


Di: 


This "D1:", which appears to the left of the cursor, serves two purposes, First, it is 
the Command Processor's prompt for you to enter a new command. Second, it indicates 
that drive one (D1:) is currently the “default” drive. The default drive is the one which 
DOS XL will use whenever you provide a filespec which doesn't explicitly give a disk 
drive device specifier. For instance, DOS XL would use the default drive when you use 
filespecs like GEORGE, HERNY.TXT, MYPROG.BAS. If you explicitly give a drive 
Specification as part of your filespec (D1:GEORGE, D3:HENRY.TXT, 
D2:MYPROG.BAS), DOS XL will use the drive you explicitly specified. The default 
_ drive is also the one DOS XL will go to when you enter a Command Processor 
command which requires DOS XL to load a special utility program from your system 
diskette. For instance, the COPY command requires DOS XL to load the COPY.COM 
program from your currently selected default drive. Changing the default drive is 
discussed later in this section. 


The way in which you must type any DOS XL command, along with the way you must 
type any required/optional additional information required by the command (the 
command parameters), is called the “syntax” of the command. If you do not type the 
command you wish to issue to DOS XL using the correct “syntax” for that command, 
DOS XL will either do the wrong thing (if it thinks you meant something else which it 
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did understand), or it will give you an error message telling you it didn't understand 
what you wanted. 


In the descriptions of the commands below, special symbols are used to summarize 
each command's syntax. These symbols have the following meaning: 


<> Angle Brackets: These are used to surround the description of a parameter. They are 

L used to indicate that you are not supposed to type what appears between them as part 
of the command, but rather to substitute a file's name (<file- name>), a drive identifier 
(<drive-id>), or some other piece of information in place of the <token>. The 
<token>s are simply place holders for some other varying piece of information which 

L you must supply. Exactly what you should substitute for each <token> depends upon 
the command you are issuing, and therefore each <token> you should give with a 
command is detailed with the discussion of that command. 


<RETURN> This is a special <token> which is used to represent the key labelled 
“RETURN” on your Atari keyboard. 


(] Square Brackets: These are used to surround the sections of a command which are 
optional and therefore need not be typed. Square brackets are sometimes nested one 
inside the other. For instance, [[<drive-id>]<file-name>] indicates that the entire thing 
is optional and therefore need not be typed, or just <file-name> can be typed, or 
<drive-id> and <filename> can be typed. However, <drive-id> cannot be typed alone. 


Lower Case Letters: These are used for <loken> names to further emphasize the fact 
that the <token> itself is not supposed to be typed, but rather some piece of 
information is supposed to be substituted for the <token>. 


Upper Case Letters: Whenever upper case letters appear in a command description, 
they must be typed exactly as they appear (or not at all if, and only if, they appear as 
optional within square [] brackets). 


Spaces (blanks): Spaces only appear in command descriptions where ever you must 
type them. Spaces are never placed in a command description simply to enhance 
readability. 


They must be typed exactly as they appear (or not at all if, and only if, they appear as 
optional within square [] brackets). The only exception to this is the hyphen/dash (-) 
which is often used as part of <token-names>. 


: 
q Other characters: All other characters should be treated exactly like upper case letters. 
4.2 DOS XL Intrinsic Commands 


Instrinsic Commands are one class of commands which can be given anytime the 
Command Processor's prompt (D#:) appears. Intrinsic commands differ from extrinsic 
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commands by the fact that everything necded to process these commands is already 
contained within the DOS XL which was loaded into memory when you booted your 
system. DOS XL does not need to go back to your system diskette in order to get 
more information when you issue an intrinsic command, therefore you don't need to 
have your DOS XL diskette in the disk drive when you issue one of these commands. 


The following is a summary of the intrinsic commands: 
@cbatch-file> 
CAR[TRIDGE} 
D#: 


DIR{ECTOR Y] [<drive-id>][<file-spec>] <list-spec> 

ERA[SE] [<drive-id>][<file-spec>] 

LOA[D] [<drive-id>][<file-name>] 

PRO[TECT] [<drive-id>}[<file-spec>] 

REM[ARK] <any-text> 

REN{AME] [<drive-id>]<old-name> <new-name> 

RUN [<entry-address>] 

SAV[E] [<drive-id>]<file-name> <starting-address> <ending-address> 
TYP{E] [<drive-id>}<file-name> <list-spec> 

UNP[ROTECT] [<drive-id>]<filespec> 


Note that all intrinsic commands may be abbreviated to their first three characters. As 
a matter of fact, DOS XL only looks at the first three characters while testing for an 
intrinsic command. Each of the commands will be covered in detail later in this 
manual; however, to give you a fecl of the intrinsic commands, let's look at the 
DIRECTORY command. While looking at these examples, assume the “D1:" at the 
beginning of cach line is the default drive and has been displayed on the screen by the 
Command Processor. 


D1:DIRECTORY list names of all files on disk in drive one 
DI:DIRTY r 0 OS ee ee ee 
DI -DIR “ * ” ” ” ” ” " * ” 
DI1:DIR *.* 1 sa oe 7. ep 6 
DI:DIR D1: : . ee ae ee 
D1:DIR D1:*.* “4 - we, GS ee 
DI DIR D2: " RO COS TS TD Noe "two 
D1:DIR D2:*.* ° ? iagqe (ar ae Tear” Pe 
D1:DIR *.OBJ list names of all files with .OBJ extension 
D1:DIR D2:*.ASM list names of all files with .ASM extension 
on drive two 
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4.2.1 How Do You Execute a Batch File From Command Level 


@cbatch-file> 


<batch-file> 

This is the name of the file containing the batch commands for DOS XL wo being 
executing. Only the primary part of the file name can be given, DOS XL assumes the 
full name to be "<batch-file>.EXC". 


None 


Description: 


The @ command tells DOS XL to begin taking commands from a batch file. This file 
is a text file which may contain both intrinsic and extrinsic DOS XL commands. 


The "END" command is used within the batch file to tell DOS XL to stop taking its 
commands from the file and return to taking commands from the keyboard. In 
addition, the “"CAR"tridge command will cause DOS XL to return to taking commands 
from the keyboard after the “CAR"tridge command has been executed. 


See “Controlling DOS XL Without Being There” for more details. 


Example(s): 
Suppose the file TEST.EXC contains the following commands: 


DIR D:<RETURN> DIRD2:<RETURN> END<RETURN> 
Issuing the command: 


@TEST<RETURN> 

would tell DOS XL to start taking commands from the file "TEST.EXC”. This would 
cause DOS XL to give a directory listing of the files on the diskette in drive one, 
followed by a listing of files on the diskette in drive two. 

4.2.2 How Do You Go To a CARtridge From Command Level? 


Command Syntax: 
CAR[TRIDGE 
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None 


The “CAR"tridge command allows the user to enter a cartridge from the command level 
of DOS XL. The cartridge will retain control of your Atari computer until a cartridge 
dependent command is given telling the cartridge program to return control to DOS XL. 
(For the Atari BASIC cartridge, this command is “DOS".) 

SPECIAL NOTE: Some cartridges will not return control to DOS, normally because 
they are not intended to be used together with DOS. Most game cartridges are designed 
this way. 

If no cartridge is present, DOS XL will respond with an error message. 

Example(s): 

Given that the Atari BASIC cartridge is installed, typing: 

CAR<RETURN> 


will start BASIC running. 
4.2.3 How Do You Change The Default Drive From Command Level? 
De<1-4>: 


<1l-4> 
This indicates a single digit from "1" to "4" which indicates which drive is to become 
the new default drive, 


None 


en 
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Whenever the DOS XL's Command Processor is ready to accept & command from you, it 


prompts you with “D#:". This prompt serves a secondary purpose: it reminds you 
which disk drive is currently selected as the default drive. 


Anytime you specify a filename to Command Processor (as part of either an intrinsic 
or extrinsic command), if you omit the disk specifier, the Command Processor prefixes 
the filename with the same three characters with which it prompted you. For example, 
when DOS XL is first booted, the current default drive is drive one, the Command 
Processor is prompting you with "D1:"; and the Command Processor would see a 
command like "PROTECT MYFILE.TXT" as "PRO D1:MYFILE.TXT". 

If you have more than one drive, however, it is sometimes convenient to designate 
drive other than drive one as the default disk drive. So, if you type "D2:" in response 
to the DOS XL prompt, the Command Processor will begin displaying a new prompt, 


“D2:", and any files given without a drive designator will be presumed to be on drive 
two. 


| Note that DOS XL actually supports D1: through D8:, but most standard drives may 
only be addressed as D1: through D4:. 
SPECIAL NOTE: Unless DOS XL is modified as discussed under "What Do You Do If 
You Have More Than Two Drives?”, it will only accept drives D1: and D2:. 

| Example(s); 

| Given that the Command Processor is currently prompting you with: 

| D1: 

DIR<RETURN> 

you would then get a directory listing for the diskette in drive one. If you then typed: 

D2:<RETURN> 

the Command Processor would begin prompting you with: 

D2: 

and if you then typed: 

DIR<RETURN> 
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you would get a directory listing for the diskette in drive two since that would now be ~~ 
your default drive. Finally, typing: 


D1:<RETURN> 


would restore your default drive to being drive one. 


4.2.4 How Do You Get a DI] Rectory listing From Command Level? 
Command Syntax: 
DIR[ECTORY] [<drive-id>)[<file-spec>) [<list-spec>] 


<drive-id> 


This is an optional parameter which, if used, tells DOS XL to list the directory of files 
from the specified drive rather than the default drive. If <drive-id> is not included as 
part of the command, DOS XL will assume the default drive. 


<file-spec> 

This is an optional parameter which, if used, tells DOS XL to limit the directory 
display to just those files which meet the <file-spec>. Wildcard characters can be 
included as part of <file-spec> (see "So What is a Diskette File Anyway?” for 
discussion of wildcard characters), thus permitting DiRectory listings of certain groups 
of files. 


<list-spec> 
This is an optional parameter which, if used, tells DOS XL where to send the directory 
listing instead of the screen. See Problem Preventor note below. 


Command Option(s): 


None 


The DiRectory command searches the disk directory of the specified disk (or the current 
default drive, if <drive-id> is omitted) for all files matching <file-spec>. The names of 
all files matching the specifier are then printed to the screen, together with the length 
of the file (in sectors) An asterisk preceding the file's name indicates that the file is 
protected from erasure, writing, or renaming. 


If <list-spec> is included as part of the command, the directory listing will be sent to 
that file or device instead of to the screen. 
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PROBLEM PREVENTOR: If <list-spec> is a file rather than a device, the file 
should be on a drive other than the one from which the directory listing is being 
produced. Sending a directory listing to a file on the same drive as that from which 
the directory listing is being produced will not, in general, work. 


_ Example(si 





For example, issuing the command: 

DIR D1: P:<RETURN> 

will send to the printer a listing of all files on drive one. And the command: 

DIR AB*.C??<RETURN> 

will display on the screen a listing of all files on the diskette in the default drive 


which match the file ‘specification "AB*.C??". Given that the diskette contains the 
following files, the table show which files will be listed and which won't: 


ABX.CXX listed 
ABX.BXX not listed 
ACX.CXX not listed 
AB.CUR listed 
BB.CUR not listed 
ABCDEF.CNN listed 
ABCDEF.BNN not listed 

And, just: 

DIR<RETURN> 


will display on the screen a listing of all files on the diskette in the default drive. 


4.2.5 How Do You ERAse Files From Command Level? 
Command Syntax: 
ERA[SE] [<drive-id>]<file-spec> 


<drive-id> 

This is an optional parameter which, if used, tells DOS XL to erase the files from the 
specified drive rather than the default drive. If <drive-id> is not included as part of the 
command, DOS XL will assume the default drive. 
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<file-spec> 

This is a required parameter which tells DOS XL which file(s) are to be erased. 
Wildcard characters can be included as part of <file-spec> (see "So What is a Diskette 
File Anyway?" for discussion of wildcard characters), thus permitting the erasure of 
certain groups of files. 


Command Option(s): 


None 


Description: 
The ERAse command permanently removes files from a disk. All files matching the 
<file-spec> on the specified drive (or the current default drive, if <drive-id> is omitted) 
will be erased from the disk. These files will no longer be shown when a DiRectory 
command is issued, nor will they be available for any type of file access. If DOS XL 
cannot find any files on the diskette which match <file- spec>, it will respond with 
“FILE NOT FOUND". 

PROBLEM PREVENTOR: This command causes the irreversible deletion of files 


from the disk. It should be used with care. Use the PROtect command to guard files 
against accidental erzsure. 


Example(s): 
Typing the command: 
ERASE *.BAK<RETURN> 


will erase all files with an extension of .BAK that are unprotected and that reside on 
the current default drive. The command: 


ERA D2:DUP.SYS<RETURN> 


will erase the file named DUP.SYS from disk in disk drive number two. All 
UNProtected files on the default drive can be erased with the single command: 


ERA *.*<RETURN> 
PROBLEM PREVENTOR: Use this command with caution! 
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4.2.6 How Do You LQAd a Binary File From Command Level? 


Command Syntax: 
LOA[D] [<drive-id>]<file-name> 


<drive-id> 

This is an optional parameter which, if used, tells DOS XL that the file to be LOAded 
should come from the specified drive rather than the default drive. If <drive-id> is not 
included as part of the command, DOS XL will assume the default drive. 


<file-name> 
This is a required parameter which tells DOS XL which file is to be LOAded. 


Command Option(s); 


None 


The LOAd command allows the user to load binary load image files into user memory. 
The files must be compatible with the normal binary object files used by Atari's own 
DOS. Such files are produced by Atari's Assembler/Editor Cartridge as well as most 
upgraded products such as Optimized Systems' ACTION compiler and MAC/65 
assembler. 


PROBLEM PREVENTOR: LOAding binary image files is a DOS XL function 


required by very advanced programmers. Most DOS XL users have no use for this 
command, and therefore need not understand how to use it. 


Example(s); 

Typing: 

LOA FASTGAME.COM<RETURN> 

will cause DOS XL to LOAd the binary image file FASTGAME.COM into memory. 
DOS will not automatically transfer control to this file (start it executing) unless the 


file contains certain load information which causes DOS XL to transfer control. See 
"Using DOS XL With Assembly Language” for a full discussion. 
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4.2.7 How Do You PROtect Files From Command Level? 


Command Syntax: 
PRO[TECT] [<drive-id>)<file-spec> L 


<drive-id> 

This is an optional parameter which, if used, tells DOS XL to protect the files on the 
specified drive rather than the default drive. If <drive-id> is not included as part of the 
command, DOS XL will assume the default drive. 


<file-spec> 

This is a required parameter which tells DOS XL which file(s) are to be protected. 

Wildcard characters can be included as part of <file-spec> (see "So What is a Diskette 
| File Anyway?" for discussion of wildcard characters), thus permitting the protection of 
| certain groups of files. 


None 


The PROtect command protects files on a disk from future ERAsure, RENaming, or any 
other alteration (including the writing of any data into the file). All files matching the 
<file-spec> on the specified drive (or the current default drive, if <drive-id> is Omitted) 
will be protected. These files will then be shown on a DIRectory listing with 
asterisks/stars (*) in front of their names. If DOS XL cannot find any files on the 
diskette which match <file-spec>, it will respond with "FILE NOT FOUND", 
Example(s): 

Typing the command: 

PROTECT *.BAK<RETURN> 


will protect all files with an extension of .BAK that reside on the current default drive. 
The command: 


PRO D2:DUP.SYS<RETURN> 


will protect the file named DUP.SYS on the disk in disk drive number two. All files 
on the default drive can be protected with the single command: 


PRO *.*<RETURN> 
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4.2.8 How Do You REName a File From Command Level? 


Command Syntax; 
REN[AME] [<drive-id>]<old-name> <new-name> 


<drive-id> 

This is an optional parameter which, if used, tells DOS XL to rename the file on the 
specified drive rather than the default drive. If <drive-id> is not included as part of the 
command, DOS XL will assume the default drive. 


<old-name> 
This is a required parameter which tells DOS XL which file is to be renamed. 


<new-name> 
This is a required parameter which tells DOS XL what the new name of the file is to be. 


None 


a on 


The REName command changes the name of a file on a disk from <old- name> to <new- 
name>. The renamed file will then be shown on a DIRectory listing with its new 
name. If DOS XL cannot find a file on the diskette which matches <old-name>, it will 
respond with "FILE NOT FOUND". 


PROBLEM PREVENTOR: Although DOS XL will accept wild-card characters ("*" 
and “?") as part of <old-name>, REName should not be used with wild-card characters. 
Using wild-card characters as part of the REName command can permanently damage 
your diskette directory, preventing you from accessing your files. 


PROBLEM PREVENTOR: When using both DOS XL and Atari DOS, it is possible 
to use the rename command to create two files with the same name. If this condition 


occurs, use the COPY command with the query (-Q) option to transfer the two files to 
separate disks where they may then be renamed back. 


Example(s); 
Typing the command: 
RENAME MYFILE.NEW MYFILE.OLD<RETURN> 


will change the name of the file “MYFILE.NEW" on the default drive to 
"MYFILE.OLD". The command: 
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REN D2:HELLO.TXT GOODBYE.TXT<RETURN> 


will rename the file "HELLO.TXT" on the disk in disk drive number two to 
“GOODBYE.TXT". 


4.2.9 How Do You RUN a Machine Language Program From Command 
Level? 


Command Syntax: 
RUN [<entry-address>] 


<entry-address> 

This is an optional parameter which, if present, tells DOS XL the memory address to 
which control is to be transferred in order to begin execution of the machine language 
program. The address must be supplied as a hexadecimal number. If <entry-address> is 
not supplied, the address contained in the DOS XL "RUNLOC"” field is used instead. 
See “Using DOS XL With Assembly Language” for a discussion of "RUNLOC”. 


None 


The RUN command allows the user to execute a binary load image file once it has been 
LOAded into user memory. The correct <entry- address> or contents of "RUNLOC” (sec 
"Using DOS XL With Assembly Language” for a discussion of "RUNLOC”") are very 
dependent upon the particular machine language to be cxecuted using the RUN 
command. 


PROBLEM PREVENTOR: RUNning binary image files is a DOS XL function 
required by very advanced programmers. Most DOS XL users have no use for this 
command, and therefore need not understand how to use it. Since there is no way for 
DOS XL to check and see if the <entry-address> supplied is actually the start of a valid 
machine language program, your Atari computer will probably "die" (stop talking to 
you) if you supply an invalid <entry-address> (or the contents of "RUNLOC" are 
invalid). If this happens, you will need to turn your Atari computer off and then on 
again in order to “bring it back to life” (reincarnate?) it. 


SPECIAL NOTE: Many standard programs designed to be executed under DOS XL, 
as well as most of the DOS XL extrinsic commands, will set "RUNLOC” to their 
special re-execute (warm start) entry address. Thus, for example, if you return to the 
DOS XL Command Processor to perform only intrinsic commands, you may be able to 
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re-start the last program or DOS XL extrinsic command by simply typing 
“RUN<RETURN>". At the time of writing this, Optimized Systems’ BASIC A+ and 
MAC/65 (for example) both support this capability: simply type "RUN<RETURN>"” 
from Command Processor to re-start these two programs. 


Example(s): 
Typing: 
RUN 4EFD<RETURN> 


will cause DOS XL to transfer control of your Atari computer to the binary image file 
already loaded into memory and who's entry (first instruction) address is (hopefully) at 
4EFD ("JMP $4EFD"). Alternately: 


RUN<RETURN> 


will cause DOS XL to transfer control of your Atari computer to the binary image file 
already loaded into memory and who's entry address is (hopefully) contained in the 
DOS XL memory location "RUNLOC" ("JMP (RUNLOC)"). 


4.2.10 How Do You SAVe a Binary File From Command Level? 
Command Syntax: 
SAV[E] [<drive-id>]<file-name><starting-address><ending-address> 


<drive-id> 

This is an optional parameter which, if used, tells DOS XL that the file is to be SAVed 
to the specified drive rather than the default drive. If <drive-id> is not included as part 
of the command, DOS XL will assume the default drive. 


<file-name> 
This is a required parameter which tells DOS XL the name of the file under which to 


SAVe the binary memory image. 


<starting-address> 
This is the memory address, in hexadecimal, of the first byte which DOS XL is to write 
to the file. 


<ending-address> 


This is the memory address, in hexadecimal, of the last byte which DOS XL is to write 
to the file. 


153 


ii ta a 


DOS XL for Indus GT Reference Manual 
None 


The SAVe command allows the user to write portions of memory to disk files in 
standard binary file format. The two addresses define the portion of memory to be 
writien to disk; the second address must be greater than or equal to the first. A file 
which has been ‘SAVed' may later be returned to memory using the LOAd command. 


PROBLEM PREVENTOR: SAVing binary image files is a DOS XL function 
required by very advanced programmess. Most DOS XL users have no use for this 
command, and therefore need not understand how to use it. 


Example(s): 
The command: 


SAVE PAGE4000.IMG 4000 40FF<RETURN> 
will save the 256 byte “page” of memory at $4000 to the disk file PAGE4000.IMG on 
the default drive. 


Command Option(s): 
| 
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4.2.11 How Do You TYPe a File To The Screen From Command Level? 


Command Syntax: 
TYP(E] (<drive-id>]<file-name> <list-spec> 


<drive-id> 

This is an optional parameter which, if used, tells DOS XL which drive contains the 
diskette on which the file to be TYPed is located. If <drive-id> is not included as part 
of the command, DOS XL will assume the default drive. 


<file-name> 
This is a required parameter which tells DOS XL the name of the file you wish TYPed. 


<list-spec> 

This is an optional parameter which, if used, tells DOS XL where to send the typed file 
listing instead of the screen. This parameter can be used to specify either a device 
(such as "P:" for the printer), or another disk file. 


Command Option(s): 


None 


The TYPe command instructs DOS XL to copy a text file to the screen, another file, or 
device. If the optional <list-spec> is not specified, the text file your specify will be 
copied to the screen. 


Example(s): 


To view the commands in the "STARTUP.EXC" file included as part of your DOS XL 
System Master diskette from Future Systems, issue the command: 


. 


TYP STARTUP.EXC<RETURN> 


(This command assumes that your DOS XL System Master diskette is in the default 
drive.) If the optional <list-spec> is specified, the text file will be copied to the <list- 
spec> device or file. For example, to copy the "STARTUP.EXC” file to the printer, 
issue the command: 


TYP STARTUP.EXC P:<RETURN> 


Another use of the TYPe command is to create a short text file. For instance, you can 
create a new "STARTUP.EXC" batch file via the following: 


135 


_——— eS —SCS—C—.CCCT~“:=tet””Prd*?sr/ 


DOS XL for Indus GT Reference Manual — 
TYP E: STARTUP.EXC<RETURN> 


This command tells DOS XL that you wish to copy text from the screen E:ditor to the 
disk file "STARTUP.EXC". See "How Do You Use Your Other Non-Disk Devices" for a 
discussion of the screen E:ditor ("E:" device). When the screen E:ditor is the source 
“file", as in this example, you are actually the source "file" since input from the screen 
E:ditor comes from the Atari computer’s*keyboard. This means you will require a way 
to tell DOS XL when you are finished typing the “source file". To do this, you hold 
down the key labelled “CONTROL” or “CTRL”, and then type the “3" key. This will 
create a signal to DOS XL which tells it that you have finished typing the “source 
file". When you use the screen E:ditor as the “source file", you cannot use the cursor 
movement keys to edit any linc on except the line you are currently typing. It is this 
restriction which makes this command a little difficult to use for creating anything but 
short text files. 


Finally, the TYPe command may also be used to copy TEXT files from one disk file to 
another by using disk file names for both <file- name> and <list-spec>. For example: 


TYP STARTUP.EXC UPSTART.EXC<RETURN> 
will copy the "STARTUP.EXC" file to the "UPSTART.EXC” file. 


4.2.12 How Do You UNProtect Files From Command Level? 
Command Syntax: 
UNP{ROTECT] [<drive-id>]<file-spec> 


<drive-id> 

This is an optional parameter which, if used, tells DOS XL to unprotect the files on the 
specified drive rather than the default drive. If <drive-id> is not included as part of the 
command, DOS XL will assume the default drive. 


<file-spec> 
This is a required parameter which tells DOS XL which file(s) are to be unprotected. 
Wildcard characters can be included as part of <file-spec> (see "So What is a Diskette 


File Anyway?" for discussion of wildcard characters), thus permitting the unprotection 
of certain groups of files. 


| Command Option(s): 


None 
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Description: 

The UNProtect command unprotects files on a disk, permitting future ERAsure, 
RENaming, or any other alteration (including the writing of any data into the file). All 
files matching the <file-spec> on the specified drive (or the current default drive, if 
<drive-id> is omitted) will be unprotected. These files will no longer be shown on a 
DiRectory listing with asterisks/stars (*) in front of their names. If DOS XL cannot 
find any files on the diskette which match <file-spec>, it will respond with "FILE NOT 
FOUND". 


Example(s); 
Typing the command: 
UNPROTECT *.BAK<RETURN> 


will unprotect all files with an extension of .BAK that reside on the current default 
drive. The command: 


UNP D2:DUP.SYS<RETURN> 


will unprotect the file named DUP.SYS on the disk in disk drive number two. All files 
on the default drive can be unprotected with the single command: 


UNP *.*<RETURN> 


4.3 DOS XL Intrinsic Batch Commands 

Intrinsic batch commands differ from standard intrinsic commands since they are only 
functional when used inside a batch (.EXC) file. Like standard intrinsic commands, 
intrinsic batch commands differ from extrinsic commands by the fact that everything 
needed to process these commands is already contained within the DOS XL which was 
loaded into memory when you booted your system. DOS XL does pot need to go back 
to your system diskette in order to get more information when you issue an intrinsic 
command from within a batch file, therefore you don't need to have your DOS XL 
diskette in the disk drive because your batch file contains one of these commands. 
However, you may still need your DOS XL diskette in the drive if that is where the 
batch file from which DOS XL is taking its commands is located. 


The following is a summary of the intrinsic batch commands: 
END 
NOS[CREEN] 
REM[ARK] [<any-text>] 
SCR[EEN] 
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Note that all intrinsic batch commands may be abbreviated to their first three 
characters. As a matter of fact, DOS XL only looks at the first three characters while 
testing for an intrinsic batch command. 


4.3.1 How Do You END a Botch File? 


The END command causes DOS XL to stop reading commands from a batch file and to 
resume prompting the user for commands. This command has no effect outside of a 
batch file. 


Examples); 
Examples are provided under "How Do You Execute a Batch File From Command Level" 


and “Controlling DOS XL Without Being There”, as well as with the examples for the 
other intrinsic batch commands. 


4.3.2 How Do You Request NOQ-Screen Output From a Batch File? 


NOS[CREEN] 
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Normally, all commands encountered during batch execution are displayed on the screen 


as if they were typed in by the user. The NOScreen command can be used to prevent 
the commands from displaying. All commands within the batch file will then no 
longer be displayed until the batch file is stopped for any reason or a SCReen 
command is encountered, This command is only effective from within a batch file. 


Example(s); 
Given the execution of a batch file containing the following commands: 


NOS<RETURN> 

REM THIS MESSAGE WILL NOT BE DISPLAYED 
DIR<RETURN> 

SCR<RETURN> 

REM THIS MESSAGE WILL BE DISPLAYED 
DIR<RETURN> 

END<RETURN> 


all three DiRectory listing will appear on the screen, but tic second DiRectory 
command itself won't be displayed by DOS XL (the second DiRectory listing will 
appear to have been produced for no reason). The SCReen command will reverse the 
effect of the NOScreen command, thus permitting the third DiRectory command to be 
displayed. The NOScreen command will be displayed by DOS XL because it has yet to 
be executed and therefore the displaying of commands has yet to be suppressed. 
Similarly, the SCReen command will not be displayed since it has yet to be executed 
and therefore the displaying of commands has yet to be resumed. 


433 How Do You Display REMarks From a Batch File? 


Command Syntax: 
REM[ARK] [<any-text>] 


<any-token> 7 -: 
This can be any random text your little heart desires. 
None 
Description: 
ae -~ > 


The REMark intrinsic batch command is used to place messages inside batch files 
which are displayed by DOS XL (provided NOScreen hasn't been executed) as the batch 
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file execution progresses. DOS XL completely ignores this command except for 
displaying the command. 

Example(s); 

A batch file containing the following commands: 


NOS<RETURN> 
REM THIS MESSAGE WILL NOT BE DISPLAYED<RETURN> 


SCR<RETURN> 
REM THIS MESSAGE WILL BE DISPLAYED<RETURN> 


END<RETURN> 
will only display the second REMark command. 
4.3.4 How Do You Request SCReen Output to Resume From a Batch 
File? 
SCR[EEN] 
Command Token(s): 
None 


None 


Normally, all commands encountered during batch execution are displayed on the screen 
as if they were typed in by the user. The NOScreen command can be used to prevent 
the commands from displaying. All commands within the batch file will then no 
longer be displayed until the batch file is stopped for any reason or a SCReen 
command is encountersd. This command is only effective from within a batch file. 


Example(s): 


Given the execution of a batch file containing the following commands: 


REM THIS MESSAGE WILL NOT BE DISPLAYED 
DIR<RETURN> 

SCR<RETURN> 

REM THIS MESSAGE WILL BE DISPLAYED 
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DIR<RETURN> 
END<RETURN> 


all three DiRectory listings will appear on the screen, but the second DiRectory 
command itself won't be displayed by DOS XL (the second DiRectory listing will 
appear to have been produced for no reason). The SCReen command will reverse the 
effect of the NOScreen command, thus permitting the third DIRectory command to be 
displayed. The NOScreen command will be displayed by DOS XL because it has yet to 
be executed and therefore the displaying of commands has yet to be suppressed. 
Similarly, the SCReen command will not be displayed since it has yet to be executed 
and therefore the displaying of commands has yet to be resumed. 


4.4 Extrinsic DOS XL Commands 


The extrinsic commands are machine language programs which are run by DOS XL's 
Command Processor. Any standard Atari binary file containing the ".COM” extension 
may be used as a DOS XL extrinsic command. The DOS XL “COPY” command is one 
such extrinsic command. If you perform the DiRectory command to view the contents 
of your DOS XL System Master diskette, you will see a file named "COPY.COM". The 
program in the "COPY.COM" file is what is executed when the "COPY" command is 
typed. 


Remember, extrinsic commands are not actually part of the DOS XL operating system. 
Whenever an extrinsic command is executed from DOS XL, the system must go looking 
on the diskette for a ".COM" file associated with the particular extrinsic command 
issued and load that file into your computer. For example, when you issue the 
extrinsic command “DUPDSK" the system will go looking on the diskette in drive one 
for a file called "DUPDSK.COM". If no ".COM" file having the same name as the 
command is on the diskette, the system will respond with a "FILE NOT FOUND” error. 
So remember: whenever you issue an extrinsic command to the system, its ".\COM” file 
must be on the diskette for the command to execute properly. 


Whenever you type any command to DOS XL, the first three characters of the command 
are compared to the intrinsic command list contained within the Command Processor. 
If the command is not in the intrinsic list, it is assumed to be extrinsic. Because the 
Command Processor first checks its own internal intrinsic command list, no extrinsic 
command program may start with three characters which match any of the intrinsic 
commands. For example, an extrinsic command program named “PROCESS3.COM” 
could not be executed by simply typing "PROCESS3", since DOS XL would view that 
as the intrinsic command “PROtect". There are two simple solutions to this problem 
should you encounter it: 


1) Rename the extrinsic ".COM" file to a name which doesn't begin with an intrinsic 
command. Note: the ".COM” extension must still be used. 
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2) Execute the extrinsic command using a LOAd and then RUN intrinsic command 
sequence. For example, the cxtrinsic command "PROCESS3" could be executed by 
doing: 


LOAD PROCESS3.COM<RETURN> 
RUN<RETURN> 


After the DOS XL Command Processor has searched its own internal list of intrinsic 
commands and found that the command you typed doesn't match any of those, it will 
do the following: 


1) If you did not type a drive identifier ("D1:", "D2:", etc.) in front of your command, 
the Command Process will place the default drive identifier in front of your command. 


2) Place the extension ".COM” after your command. Note: the Command Processor 
will place ".COM" after your command regardless of whether or not you specified a 
different extension, so it is not possible to override the ".COM" extension when 
issuing an extrinsic command. 


3) Attempt to locate the ".COM" file on the specified drive. If it cannot locate the 
file, it will respond with a “FILE NOT FOUND" error. 


4) Test the contents of the file to make sure it is proper Atari binary file format. See 
"How Do You LOAd a Binary File From Command Level?” for a discussion of the Atari 
binary file format. 


5) Load the contents of the file (the program) into memory, and then execute the 
program. 


NOTE: If the Command Processor has a problem performing any step in the above 
procedure, it will respond with an appropriate error message. 


SPECIAL NOTE: The above procedure shows that you can prefix an extrinsic 
command with a drive identifier in order to cause the Command Processor to take the 
associated “.COM” file from a drive other than the default drive. 


PROBLEM PREVENTOR: Never attempt to supply any extension (including 
"COM") as part of any extrinsic command you type. As the above procedure shows, 
the Command Processor always appends the ".COM" extension to the extrinsic 
command you type regardless of when you have typed a different extension. This 
means that if you type the command “COPY.COM", the Command Processor will go 
looking for the program file "COPY.COM.COM” and, of course, not find it. 


Most of the extrinsic commands you will use (such as "COPY") are supplied as part of 


your DOS XL System.Master diskette. The number of possible extrinsic commands is 
not, however, limited to these few. If you have experience writing assembly/machine 
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language programs for your Atari computer, you can write an extrinsic command to 
perform virtually any function. See "Using DOS XL With Assembly Language” for a 
discussion of how to write extrinsic commands. 


SPECIAL NOTE: It isnot possible to write extrinsic commands using Atari 
cartridge BASIC. Extrinsic commands must be in a machine language form in order for 
the Command Processor to execute them, and therefore either an assembler must be 
used (such as Atari's Editor/Assembler Cartridge), or a higher level language compiler 
(such as Optimized System's ACTION! Compiler). 


Most of the extrinsic commands supplied on your DOS XL System Master disketle car 
be easily re-executed once they have terminated by simply issuing the RUN intrinsic 
command. Exceptions to this rule are the extrinsic commands "COPY", "SDCOPY", 
and “CONFIG”. This feature may also work with other extrinsic commands you may 
have received from somewhere other than your DOS XL System Master diskette, it 
depends upon the particular extrinsic command 


PROBLEM PREVENTOR: You can only issue intrinsic commands between the 
time the extrinsic command terminated and yo. re-execule it using the RUN intrinsic 
command. 


The following is a discussion of each extrinsic command supplied as a standard part of 
your DOS XL System Master diskette. 


4.4.1 How Do You CLeaR a DiSK From Command Level? 


This utility is used to force your non-Atari disk drive to initialize a diskette just like 
the Atari 810 disk drive does. Hopefully any program that does not work with a 
diskette initialized in your non-Atari disk drive will work after you initialize the 
diskette using the CLRDSK extrinsic command. 


NOTE: CLRDSK formats the diskette first, then writes zeroes to all sectors except the 
directory, boot and VTOC sectors. 
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SPECIAL NOTE: Your Indus GT drive should not require the CLRDSK extrinsic 
command, The Indus GT initializes its single density diskette just like Atari's 810 
drive when you use any of the other INITialization extrinsic commands supplied with 
DOS XL. The CLRDSK extrinsic command has been distributed as part of your Indus 
GT DOS XL System Master diskette in case you own some other manufacturer's drive 
which does not perform diskette initializations properly. (Not everybody's perfect.) 


Examplc(s): 

With the DOS XL System Master diskette in drive one, and the default drive set to one 
(Command Processor is prompting you with “D1:"), you would type: 
CLRDSK<RETURN> 


Once the Command Processor loads and executes CLRDSK.COM, CLRDSK will ask 
you: 


Drive to clear? 


You can then respond by typing "1" followed by the <RETURN> key. This will tell 
CLRDSK you wish to clear the diskette you are about to insert into drive one. 
_ CLRDSK will then prompt you with: 


Insert disk and hit return 


This prompt allows you to remove your DOS XL System Master diskette and insert the 
diskette you wish to clear. 


PROBLEM PREVENTOR: Whichever diskette you insert at this time will 
completely lose any information it may have previously contained, so it is not a good 
idea to choose the diskette on which you've placed all of your relatives addresses and 
birthdates (unless, of course, you wish to be dis-owned by your entire family). 


Once you've inserted an “okay to erase” diskette, press the <RETURN> key to tell 
CLRDSK to proceed. The clearing process takes about one minute and fifty seconds to 
perform when using an Indus GT. Other manufacturer's drives will probably take 
longer. When CLRDSK has finished clearing your diskette, it will ask you: 


Clear another disk? 
to which you can either respond “Y” for yes followed by the <RETURN> key, or “N" 
for no followed by the <RETURN> key. If you respond with “N", CLRDSK will return 


you to the Command Processor. If you respond with "Y", CLRDSK will go back to the 
“Drive to clear?" question above. 
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4.4.22 How Do You CONFIGure Drive Densities From Command Level? 


Command Syntax: 
CONFIG [<setting>] [<setting>] [<setting>] [<setting>] [-N] 
Command Token(s): 


<setting> 

These optional command parameters, if used, tells CONFIG how to configure one or 
more of the drives on your system. Each <setting> consists of two or three characters 

The first character is always the number of the drive you wish to configure ("1"-"8") 

The second one or two characters are used to specify the mode into which the drive 1s 
to be placed. “S" indicates single density, "D" indicates double density, and “DD” 
indicates double density and double sided. NOTE: Your Indus GT does not support the 
"DD" parameter, and the version of DOS XL supplied with your Indus GT does not 
support double sided drives. CONFIG does, however, still accept the "DD" parameter 
even though you should not use it. 


Command Option(s): 

-N 

This command option, if used, tells CONFIG not to display the listing of how each 
drive attached to your system is configured. 


— 


If no parameters are given, this command simply reports the configuration of all drives 
currently attached to your Atari computer. 


If one or more parameters are given, they are presumed to be requests for CONFIG to 
tell the disk drives you specified (as the first character of each parameter) to configure 
themselves in the way you specified (as the second and third characters of each 
parameter). At the same time as CONFIG is telling your drives to change their 
operating modes/densities, it is also telling the DOS XL system itself that these 
changes are being performed. This is the very important difference between changing 
the operating densities of your Indus GT(s) using the CONFIG command rather than by 
using the front panel switches on your Indus GT(s). If you use the front panel switches 
on the Indus GT(s) to change their operating densities, the DOS XL system is never 
notified of the change, and therefore DOS XL and your Indus GT(s) get confused next 
time they try to talk to each other. 


Normally, CONFIG will display a listing of all current configuration of all drives 
attached to your Atari. This listing will be suppressed if the "-N” option is used. 


PROBLEM PREVENTOR: Do not try to re-CONFIGure the drive in which you have 
your DOS XL System Master diskette (usually drive one) unless you have a DOS XL 
System Master diskette recorded in the same density as that to which you are re- 
CONFIGuring the drive. If you do not have the second DOS XL System Master diskette 
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available, then, on the drive changes densities, it will no longer be able to read the — 
“CONFIG.COM" program file off your system master diskette and therefore you will be 

unable to re-CONFIGure your drive again. You will then be forced to re-boot your Atari 
computer. 


PROBLEM PREVENTOR: At the time of writing this, Atari did not supply a disk 
drive which will respond to the CONFIG command. The Atari 810 drive is only single 
density, and therefore attempting to re~CONFIGure it would be useless anyway. The 
Atari 815 drive (a seldom seen beast) is only double density, and therefore attempting 
to re-CONFIGure it would also be useless. And last, but least, the Atari 1050 drive's 
enhanced density operating mode is not compatible with DOS XL (and most other drive 
manufacturer's double density modes), and therefore re-CONFIGuring the 1050 from 
single density (which is compatible with DOS XL) to double density (which isn't) 
would also be useless. Most other non-Atari disk drives support both single density 

_ and a DOS XL compatible double density, and therefore most of those drives will 

| respond to a CONFIGure command. However, there may be limited cases in which a 

| manufacturer's double density drive will pot respond to the DOS XL CONFIGure 
command. If you have one of these drives, you should know that the drive would not 
be considered “industry standard"; and therefore you should contact the drive's 
manufacturer (or your dealer) to see if your drive can be adjusted. NOTE: If you have a 
single density only drive, then it would be acceptable for it to not respond to the 
CONFIGure command since it does not support a double density operating mode. All! 
Indus GT drives do support the CONFIGure command. 


Example(s); 


With the DOS XL System Master diskette in drive one, and the default drive set to one 
(Command Processor is prompting you with "D1:"), if you typed: 


CONFIG 1D 2S<RETURN> 


then once the Command Processor loads and executes CONFIG.COM, CONFIG would 

begin trying to “ask” each of the eight drives which DOS XL will support to answer 

back with their current operating density. If a particular drive number doesn't answer, 

CONFIG will assume that no drive is attached to your Atari with that given number. If 

the drive answers, but tells CONFIG that it doesn't understand CONFIG's request for 
| operating density information, then CONFIG will assume that the drive is 
| “unconfigurable” (such as Atari drives). If the drive does supply operating density 
information, CONFIG will assume that the drive is “configurable” and therefore 
CONFIG will accept a re-configuralion parameter for that drive. 


With the parameters listed in the example command above, if CONFIG found that drive 


one is configurable, it would then command drive one to change to double density 
yperating mode. Likewise, if CONFIG found that drive two is configurable, it would 
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then command drive two to change to single density operating mode. Parameters 
given for non-attached/non-existent or unconfigurable drives are ignored by CONFIG. 


Since the option "-N" command option was not specified as part of the example 
command, CONFIG would then go ahead and display a table of the status of all eight of 
the possible drives. The last thing CONFIG will do before terminating back to the 
Command Processor is to tell DOS XL to re-initialize itself (this is not quite as 
dramatic as booting). This is necessary due to the changes to the operating densitic: 
of some of the drives attached to your Atari computer. 


4.4.3 How Do You COPY Files From Command Level? 
Command Syntax: 
COPY <source-spec> [<target-spec>) [-[F][Q][S][W]] 


<source-spec> 

This required parameter tells the COPY extrinsic command the name of the file (or 
group of files if the wild-card characters "*" and/or "?" is used) which is to be copied 
to the target file(s). See “So What is a Diskette File Anyway?" for a discussion of 
wild-card characters. This parameter can optionally include a drive identifier in front of 
the source file name. If the drive identifier is not used, the default drive is assumed. 


<larget-spec> 

This is an optional parameter which, if used, tells the COPY extrinsic command the 
name of the file (or group of files if the wild-card characters "*" and/or "?" are used) 
which is to receive the source file(s). See "So What is a Diskette File Anyway?" for a 
discussion of wild-card characters. This parameter can optionally include a drive 
identifier in front of the target file name. If the drive identifier is not used, the default 
drive is assumed. If no target filespec if given, but a target drive identifier is given, 
then COPY will assume that the target names are to be the same as the source names. 
If you omit the entire <target-spec> parameter, COPY will assume you wish to copy the 
files between two different diskettes using only a single drive. The target names will 
be assumed to be the same as the source names in this case, 


Command Option(s): 
-F 


Unless you specify this command option, COPY will not overwrite a target file which 
already exists. 


Q 
If you specify this command option, COPY will display each file before it is copied, 
and then ask you if you desire the file to be copied. 
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S ~~ 
If you specify this command option, you will be informing COPY that the copy is to 

be performed between two different diskettes using a single drive. This option will 
cause COPY to prompt you to exchange your source and target diskettes at the 
appropriate times during the copying process. 


-W 

Unless you specify this command option, COPY will attempt to begin the copying 
process just as soon as it is executed by the Command Processor. If you specify this 
command option, COPY will tell you it is waiting for you to insert the proper 
diskettes before it begins the copying processes. This option is normally used when 
either the source or target drive is the one from which the Command Processor must 
load "COPY.COM", but the diskette containing "COPY.COM” is not one of the 
ciskettes involved in the copying process. 


Description: 
The COPY extrinsic command copies one or more files without making any changes in 
the source file(s). If you provide a <target-spec>, all files matching the <source-spec> 


will be copied to the files indicated by the <target-spec>, which may be on the same or 
a different diskette. In you omit <target-spec> from the command line, those files 
indicated by the <source-spec> would be copied to files having the same name on the 
same drive but different diskettes. This enables the copying of files between diskettes 
using just a single drive system. 


PROBLEM PREVENTOR: COPY cannot be used to copy between diskettes of two 
different densities using a single drive. The "SDCOPY" extrinsic command must be 
used for this purpose. COPY can be used to copy between diskettes of different 
densities on two different drives, or between diskettes of the same density (either 
single or double) on a single drive. 


PROBLEM PREVENTOR: The COPY extrinsic command should never be used to 
copy the file "DOS.SYS" onto another diskette. DOS.SYS is a special file which is 
handled in a very special way by DOS XL (in order to remain fully compatible with 
Atari's own DOS). Because of this special handling, using COPY to copy DOS.SYS 
will result in the target DOS.SYS file containing two copies of the DOS.SYS file; and 
in many cases the target diskette will be unbootable. Only the INITialize extrinsic 
commands should be used to place a copy of DOS.SYS onto a diskette. After DOS.SYS 
has been placed onto a diskette using an INITialize extrinsic command, an “all files” 
copy can then be performed (by specifying the “*.*" file name). Since you will 
already have placed DOS.SYS on the target diskette, COPY will ask if it is "OK to 
overwrite?” the DOS.SYS file. Simply answer "N" for “no”, and COPY will move on 
to copying the other files. 
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PROBLEM PREVENTOR: When using COPY with only a single drive, it will not 
bother to ask you to “Insert ‘from’ disk and hit RETURN" if you answered an “OK to 
overwrite?” question with "N" for “no“. Therefore, always remember to insert your 
"from" disk before answering this question with "N". COPY will remember to ask you 
to “Insert ‘from’ disk and hit RETURN" after it is done copying the file if you answered 
“OK to overwrite?" with "Y" for "yes". 


Example(s); 


With the DOS XL System Master diskette in drive one, and the default drive set to onc 
(Command Processor is prompting you with "D1:"), if you type: 


COPY *.* 

then once the Command Processor loads and executes COPY.COM, COPY will begin to 
copy all files on the current diskette in the default drive to another diskette to be 
placed in the same drive. COPY will prompt you with: 

Insert ‘to’ disk and hit return 


when it is time to swap diskettes. When you have swapped the diskettes, press the 
<RETURN> key to tell COPY that it may proceed. When COPY needs you to re-insert 
the first diskette again, it will prompt you with: 


Insert ‘from’ disk and hit return 


to which you should respond with the <RETURN> key once you've re- inserted the first 
diskette. 


HELPFUL HINT: For this particular COPY function, the "DUPDSK" extrinsic 
command would generally be faster. 


If you type the command: 
COPY *.COM D3: -F 


COPY will copy all files having an extension of ".COM" from the current diskette in 
the default drive to the current diskette in drive three (which, if drive three is the same 
as the default drive, will cause problems). If the file(s) already exist on the diskette in 
drive three, they will be erased and rewritten because of your specifying the "-F" 
command option. 

If you type the command: 


COPY D2:C*.* D1: -Q 
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COPY will ask you each time it finds a file starting with the letter "C" whether or not 
you wish the file to be copied from the diskette in drive two to the diskette in drive 
one. If you wish to tell COPY to copy the file, you should answer with "Y" for “yes” 
followed by the <RETURN> key. To tell COPY not to copy the file, you would answer 
with "N" for "no" followed by the <RETURN> key. 


If you type the command: 
COPY D1:TEST D2:NEWTEST 


COPY will copy the file "TEST" on the diskette in drive one to the file "NEWTEST" on 
the diskette in drive two. 
If you type the command: 


COPY D1:TEST D1:NEWTEST -S 


COPY will copy the file "TEST" on the diskette in drive one to the file "NEWTEST” on 
the diskette which you will place into drive one when requested by COPY. 


4.4.4 How Do You DO Multiple Commands at Once From Command 
Level? 


Command Syntax: 
DO [<command>[;<command>[;<command>[;<command>(...] 


Command Token(s); 

<command> 

This is an optional parameter which, if used, consists of various commands which you 
wish to issue in sequence. TheSe <command>s are not restricted to just Command 
Processor intrinsic/extrinsic commands, see below. 


None 


Description: 
The DO command can be used in two ways. The first way allows you to issue several 
commands on one line. The semicolon (;) is used to separate commands which DO 
should pretend are on separate lines. The second way, in which you do not enter 
anything after the DO command, causes the DO extrinsic command to prompt you for 
zach command line you wish to be “DO"ed. 


‘ROBLEM PREVENTOR: Some extrinsic commands which inspect the Command 


rocessor's command line themselves to find parameters for their own use cannot be 
used with the DO extrinsic command. One example of such an extrinsic command is 
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the DOS XL "COPY" extrinsic command. "COPY" will not work correctly with DO 
because, on execution, COPY inspects the command line to find its source and target 
file specifications. 


Example(s); 


An example of how the DO command is not restricted to just Command Processor 
intrinsic/extrinsic commands would be: 


DO CAR;RUN “DI:MENU"<RETURN> 


This DO command would result in the issuing of, first, a Command Processor 
CARtridge intrinsic command; and, second, an Atari BASIC cartridge RUN command. 
The two commands would, first, start the Atari BASIC cartridge executing (if inserted 
into your computer); and, second, tell Atari BASIC to RUN the BASIC program 
"MENU" from drive one. This would be a very common command to place into a 
"STARTUP.EXC" file in order for your Atari computer to boot directly into running a 
BASIC program. See “What Does The STARTUP.EXC File Do?" for a further 
discussion. 


As another example, the same sort of rick would work with Atari's Assembler/Editor 
Cartridge as well as Optimized System's MAC/65 Cartridge: 


DO CAR;ENTER “D:PROGRAM.ASM";ASM ,#P:,#D:OBJECT<RETURN> 
In this example, the Assembler/Editor Cartridge would first be executed; then the 
cartridge would be instructed to enter (load) the assembler source file 


“PROGRAM.ASM" from the default drive; and then the cartridge would be instructed to 
assemble the source file into machine language. 


4.4.5 How Do You DUPlicate a DouBLe Density Disk From Command 


Level? 


DUPDBL 
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The DUPDBL extrinsic command will prompt you for the numbers of the drives 
containing the source and destination diskettes, and will ask whether it should format 
(initialize) the destination diskette prior to duplicating. The entire source diskette will 
then be copied to the destination diskette in a manner somewhat faster than the COPY 
extrinsic command would provide. The two diskettes, however, must be double density 
DOS XL diskettes originally formatted/initialized while using this version of DOS XL. 
If you specify that the destination drive is the same as the source drive, the program 
will prompt you to swap the diskettes when needed during the duplication process. 


See "How Do You Copy Between Densities With Only One Indus GT?" or "How Do You 
Copy Between Densities Using Two Drives?" for a discussion of mixed density diskette 
duplication. 


PROBLEM PREVENTOR: Do_not attempt to use DUPDBL to duplicate single 
density diskettes. This can have disastrous results. The DUPDSK extrinsic command 
is designed for duplicating single density diskettes. 


PROBLEM PREVENTOR: The DUPDBL extrinsic command will completely replace 
any information contained on whatever destination diskette you use with the 
information contained on the source diskette. If you use as a destination diskette a 
diskette which contains your secret formula for winning at the horse race track, you 
can forget about coming out ahead there for a while. 


PROBLEM PREVENTOR: When DUPDBL is finished duplicating a diskette, it will 
ask you if you wish it to “Copy same disk again (Y or N) ?". You cannot safely 
duplicate a different source diskette by answering “Y" for “yes” to this question. In 
many cases, DUPDBL will still be holding some information in memory which came 
from the first source diskette, and if you tell DUPDBL to “Copy same disk again”, it 
writes this information from the first source diskette to the new destination diskette; 
regardless of whether or not you changed source diskettes. 


Example(s); 


With the DOS XL System Master diskette in drive one, and the default drive set to one 
(Command Processor is prompting you with "D1:"), if you type: 


DUPDBL<RETURN> 


then once the Command Processor loads and executes DUPDBL.COM, DUPDBL will 
request: 


Source Disk Drive (1,2,3,4): 
to which you should respond with the number of the drive which (will) contain(s) your 
source diskette followed by the <RETURN> key. DUPDBL will then request: 


172 








DOS XL for Indus GT Reference »Manual 
Destination Disk Drive (1,2,3,4): 


to which you should respond with the number of the drive which (will) contain{s) your 
destination diskette followed by the <RETURN> key. DUPDBL will then request: 


Format Destination Disk (Y or N): 
to which you should respond with "Y" for “yes” followed by the <RETURN> key if 
your destination diskette is brand new and has ye to be initialized, or "N" for “no” 


followed by the <RETURN> key if you are using an old diskeltc which was previously 
initialized. 

At this point, DUPDBL is ready to begin; so it will prompt you with: 

Put Source Disk In Drive # 

where “#" is the drive number you specified as containing the source diskette, If you 
specified a different drive as containing the destination diskette, then DUPDBL will, at 
the same time, prompt you with: 


Put Destination Disk In Drive # 


where "#" is the drive number you specified as containing the destination diskette. 
The last thing DUPDBL wil! prompt you with is: 


When Ready, Hit RETURN 

You should place the indicated diskette(s) into the indicated drive(s) and then press the 
<RETURN> key to tel] DUPDBL it can proceed. If you specified two different drives as 
source and destination drives, then DUPDBL will be able to complete the entire 
duplication process without any further assistance from you. If you specified the same 
drive for both source and destination, DUPDBL will prompt you with: 

Put Source Disk In Drive # 

when it needs to reac ine source diskette, and: 

Put Destination Disk ‘ Drive # 


when it needs to write the destination diskette. After either of these prompts, DUPDBL 
will prompt you wilh 


When Ready, Hit RET URN 


to notify you that you need to press the <RETURN> key in order for DUPDBL to 
proceed. When DUPDBL is finished duplicating your diskettes, it will ask you: 
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Copy same disk again (Y or N) ? 


If you wish to make another duplicate of the source diskette, you should respond with 
"Y" for “yes” followed by the <RETURN> key. If you do not wish to make another 
duplicate, you should respond with "N" for “no” followed by the <RETURN> key. (See 
Problem Preventor note above.) If you answer "yes", DUPDBL will prompt you for the 
destination disk. DUPDBL does not go back and re-ask you the drive number questions 
again. If you answer “no”, DUPDBL will terminate and leave you back with the 
Command Processor. 


4.4.6 How Do You DUPlicate a Single Density DISK From Command 
Level? 


DUPDSK 


The DUPDSK extrinsic command will prompt the user for the drive numbers containing 
the source and destination diskettes, and will ask whether to format (initialize) the 
destination diskette. The entire source diskette will then be copied to the destination 
diskette in a manner somewhat faster than the COPY extrinsic command would provide. 
The two disks, however, must be of the same size and type. If the destination drive is 
the same as the source drive, the program will prompt the user to swap diskettes during 
the duplication process, : 


See “How Do You Copy Between Densities With Only One Indus GT?" or "How Do You 
Copy Between Densities Using Two Drives?" for a discussion of mixed density diskette 
duplication. 


PROBLEM PREVENT‘): Do not attempt to use DUPDSK to duplicate double 
density diskettes. This can save disastrous results. The DUPDBL extrinsic command 
is designed for duplicating double densily diskettes. 


PROBLEM PREVENTOR: The DUPDSK extrinsic command will completely replace 


any information contained on whatever destination diskette you use with the 
information contained on the source diskette. If you use as a destination diskette a 
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diskette which contains your automobile’s mileage per tank-full for the last five years, 
you can forget about computing your average miles per gallon for a while. 


PROBLEM PREVENTOR: When DUPDSK is finished duplicating a diskette, it will 
ask you if you wish it to "Copy same disk again (Y or N) ?". You cannot safely 
duplicate a different source diskette by answering "Y" for "yes" to this question. In 
many cases, DUPDSK will still be holding some information in memory which came 
from the first source diskette, and if you tell DUPDSK to “Copy same disk again”, it 
writes this information from the first source disketle to the new destination disketic; 
regardiess of whether or not you changed source diskettes. 


Exemple(s); 


With the DOS XL System Master diskette in drive one, and the default drive set to one 
(Command Processor is prompting you with "D1:"), if you type: 


DUPDSK<RETURN> 


then once the Command Processor loads and executes DUPDSK.COM, DUPDSK will 
request: 


Source Disk Drive (1,2,3,4): 


to which you should respond with the number of the drive which (will) contain(s) your 
source diskette followed by the <RETURN> key. DUPDSK will then request: 


Destination Disk Drive (1,2,3,4): 


to which you should respond with the number of-the drive which (will) contain(s) your 
destination diskette followed by the <RETURN> key. DUPDSK will then request: 


Format Destination Disk (Y or N): 

to which you should respond with "Y" for "yes" followed by the <RETURN> key if 
your destination diskette is brand new and has yet to be initialized, or “N" for “no” 
followed by the <RETURN> key if you are using an old diskette which was previously 
initialized. 

At this point, DUPDSK is ready to begin; so it will prompt you with: 

Put Source Disk In Drive # 

where “#" is the drive number you specified as containing the source diskette. If you 
specified a different drive as containing the destination diskette, then DUPDSK will, at 
the same time, prompt you with: 
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Put Destination Disk In Drive # 


where “#" is the drive number you specified as containing the destination diskette. 
The last thing DUPDSK will prompt you with is: 


When Ready, Hit RETURN 
You should place the indicated diskette(s) into the indicated drive(s) and then press the 
<RETURN> key to tell DUPDSK it can proceed. If you specified two different drives as 
Source and destination drives, then DUPDSK will be able to complete the entire 
duplication process without any further assistance from you. If you specified the same 
drive for both source and destination, DUPDSK will prompt you with: 

Put Source Disk In Drive # 
when it needs to read the source diskette, and: 


Put Destination Disk In Drive # 


when it needs to write the destination diskette. After either of these prompts, DUPDSK 
will prompt you with: 


When Ready, Hit RETURN 


to notify you that you need to press the <RETURN> key in order for DUPDSK to 
proceed. When DUPDSK is finished duplicating your disketles, it will ask you: 


Copy same disk again (Y or N) ? 


If you wish to make another duplicate of the source diskette, you should respond with 

"Y" for “yes” followed by the <RETURN> key. If you do not wish to make another 

| duplicate, you should respond with “N" for “no” followed by the <RETURN> key. (See 

Problem Preventor note above.) If you answer "yes", DUPDSK will prompt you for the 

destination disk. DUPDSK does not go back and re-ask you the drive number questions 

= If you answer “no”, DUPDSK will terminate, leaving you with the Command 
‘ocessor. 


4.4.7 How Do You [NITialize a diskette From Command Level? 
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| 
Command Options(s): 
L None 
Description: 


' 


L. The INIT extrinsic command allows you to initialize a diskette so that it may be read 
from or written to by other commands or programs. You must INITialize brand new 
~ diskettes before your Atari can read or write information to/from them. 


PROBLEM PREVENTOR: INITializing a diskette which has existing programs or 

data on it is a sure way of sending those programs or data into the great computerized 

black hole, from which no program or data has ever returned. This is, of course, okay 
if you no longer need those programs or data. 


PROBLEM PREVENTOR: The extrinsic command INIT is only used to INITialize 

diskettes in the same density as the current operating mode of the drive you select to 

perform the INITialization. If you only have a single drive and only a single density 
DOS XL System Master diskette, you must use the INITDBL extrinsic command in order 

to create a double density system master diskette. See "How Do You Make A Double 

Density DOS XL Diskette?” for a discussion of exactly that subject. If you have two or 
_ ‘more drives, you can re-CONFIGure one of your secondary drives into double density 
— mode, and then use this INIT extrinsic command. 


PROBLEM PREVENTOR: You should always use diskettes equal in quality to the 
information which you are storing onto them. If you don't value the programs or data 
_ which you are storing onto your diskettes, then feel free to use poor quality diskettes. 
If you value the programs or data you are storing onto your diskettes, use only good 
quality diskettes. We at Future Systems feel that if you felt enough about quality to 
| purchase our Indus GT, you should also be using equivalent quality diskettes. Your 
_. diskettes work as a team with your disk drives; and if one member of the team is no 
good, then the entire team will look bad. 


| PROBLEM PREVENTOR: In almost every case, you will need to INITialize a 
diskette which came from a non-Atari computer before you can use it on your Atari. 
And this INITialization process will toss any programs or data into that same 
computerized black hole referenced above. Do not try to take a diskette from a non- 
Atari computer over to your Atari, then INITialize it, and then try to read any programs 
L or data which was recorded by the other computer using your Atari. This is not the 
way to do this! Trying to read information from diskettes used on one type of 
computer using another type of computer is an extremely complex job. If you are 
trying to do this, it is possible that some software company might have a program 
which will assist you; but at the time of writing this, we at Future Systems did not 
| know of the availability of such a program. 
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PROBLEM PREVENTOR: If you are using DOS XL with either an Optimized 
Systems’ SuperCartridge or an Atari XL series computer, and the DOS XL System 
Master diskette from which you booted your system contains the file DOSXL.SYS, then 
do not use options two or three (see below) to write DOS.SYS (the DOS XL operating 
system file) to the disk. NOTE: Your original DOS XL System Master diskette from 
Future does not contain a DOSXL-SYS file, we have left it up to you to create this file 
just to be safe (see "What Do The DOS.SYS, DOS.XL, DOS.SUP, and DOSXL.SYS files 
do?"). In order to use option two or three, you must re-boot your system using @ 
diskette which does not contain a DOSXL.SYS file. You can do this by either 
renaming DOSXL.SYS to some other file name (such as just DOSXL) on your current 
system master diskette, re-boot your system, perform your INITialization, rename the 
file back to DOSXL.SYS, and finally re- boot your system again. Of course, an easier 
way to do this is to simply keep a system master diskette around which does not 
contain DOSXL.SYS on it. When you wish to INITialize, simply boot that diskette. 


PROBLEM PREVENTOR: Options two and three of INIT (see below) only write 
DOS.SYS to the diskette. They do not write DOSXL.SYS. If you are using @ 
DOSXL.SYS file on your system, you will need to COPY it from one of your existing 
system masters over to any new existing master you create. 


The INIT extrinsic command, when executed, will present you with a menu of the 
following options: 


1. FORMAT DISK ONLY 

2. FORMAT DISK AND WRITE DOS.SYS 
3. WRITE DOS.SYS ONLY 

4. REFORMAT BOOT TRACKS ONLY 

5. EXIT TO DOS XL 


Option one can be used to create what is commonly referred to as a “data diskette”. A 
“data diskette” is normally a diskette which does not contain the operating systen. 
(DOS XL in this case) and therefore cannot be booted. “Data diskette” is nothing more 
than a term someone invented to refer to such a diskette. There are no restrictions or 
what you can save onto a “data diskette”. You can put program files, extrinsic 
command files, or any other types of files, as well as data files, onto a “data diskette”. 
The advantage of creating a data diskette is that, without the DOS XL system files 
being on such a diskette, there is more room left for your own program or data files 
It takes about 26 seconds for this option to be completed using an Indus GT, anc 
possibly a little longer using @ different diskette drive. 


Option two creates a bootable system diskette. It starts by creating a “data diskette” 
just like in option one, but then finishes by adding the DOS XL system fil 
“DOS.SYS” to the diskette. NOTE: Option two does not place any extrinsic commanc 
files, the MENU.COM (DOS XL menu) file, or the DOSXL.SYS file onto the diskette. 
These are all optional files as far as DOS XL is concerned, and therefore it leaves the 
COPYing of them onto the new diskette up to you. It takes about 35 seconds for thi 
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option to be completed using’ an Indus GT, and possibly a little longer using a 
different diskette drive. 


Option three can be used to convert a “data diskette” into a “system diskette". NOTE: 
This option only writes DOS.SYS and a little bit of other information necessary to 
make the diskette bootable onto the diskette. This option assumes that you have 
previously INITialized the diskette using one of the other options. This option only 
writes the DOS.SYS file, just like option two. It takes about 10 seconds for this 
option to be completed using an Indus GT, and possibly a little longer using « 
different diskette drive. 


Option four is used to reformat the boot or system tracks of a diskette that has been 
previously INITialized while Synchromesh was active. A full discussion of 
Synchromesh and its operation appears in Section 14 of this manual; a thorough 
understanding of the Synchromesh information should be had prior to using Option 
four of the INIT menu. 


Option five is "the way out". It tclls INIT that you are finished INITializing diskettes, 
and that you wish to return to DOS XL command level (or menu level if you came from 
the menu). 


Example(s): 
With the DOS XL System Master diskette in drive one, and the default drive set to one 
(Command Processor is prompting you with "D1:"), if you type: 


INIT<RETURN> 
then once the Command Processor loads and executes INIT.COM, INIT will request: 


1, FORMAT DISK ONLY 

2. FORMAT DISK AND WRITE DOS.SYS 
3. WRITE DOS.SYS ONLY 

4. REFORMAT BOOT TRACKS ONLY 

5. EXIT TO DOS XL 


ENTER FUNCTION NUMBER: 


The normal selection if you wish to create a new bootable DOS XL diskette would be to 
choose option two (format disk and write DOS.SYS). REMEMBER: As explained in 
the Problem Preventor note above, this option cannot be used if you booted using a 
DOSXL.SYS file. To choose option two, type “2" followed by the <RETURN> key. 
After you have chosen any option (except the exit to DOS XL option), INIT will 
request: 
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ENTER DRIVE (1,2,3 OR 4): 


INIT is asking you for the number of the drive which (will) contain(s) the diskette to 
be INITialized. Assuming you only have one drive, you would type "1" for drive one 
followed by the <RETURN> key. INIT will then confirm your entries shown below, 
then ask you: 


FUNCTION 2; DRIVE 1 
ARE YOU SURE (Y OR N): (don't answer this question until you read below) 


If you respond “Y” for “yes” to the yes/no question, INIT will immediately begin 
initializing the diskette in the drive you specified. If you respond "N" for “no”, INIT 
will return you to the INITialize options menu. Assuming everything is okay and you 
wish to proceed with initializing the diskette, make sure you have the diskette you 
wish to be INITialized in the drive you specified, and then respond with "Y" for "yes" 
followed by the <RETURN> key. 


INIT will then proceed to perform whatever INITialization option you selected. Once 
INIT is finished, it will respond with: 


TASK TERMINATED NORMALLY 


HIT RETURN FOR NEXT FUNCTION 


INIT will, of course, respond with an appropriate error message rather than “task 
terminated normally” if something went wrong during the INITialization process. To 
retum to the INIT options menu, type the <RETURN> key. From the menu, you can 
either initialize another diskette or “exit to DOS XJ“ Assuming that you have just 
INITialized the only diskette you wish to INITialize, select option "4" from the menu 
and INIT will return you to DOS XL. 


4.4.8 How Do You [NI Tialize DouBLe Density Disks From Command 
Level? 


INITDBL 
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The INITDBL extrinsic command allows you to initialize a diskette in double density 
so that it may be read from or written to by other commands or programs. You must 
INITialize brand new diskettes before your Atari can read or write information to/from 
them. 


PROBLEM PREVENTOR: Initializing (INIT/INITDBL) a diskette which has 
existing programs or data on it is a sure way of sending those programs or data into 
the great computerized black hole, from which no program or data has ever returned. 
This is, of course, okay if you no longer need those programs or data. 


PROBLEM PREVENTOR: The extrinsic command INITDBL is only used to 
initialize diskettes in double density when the operating mode of the drive you select 
is single density. If you have more than one drive, it would probably be better if you 
re-CONFIGure one of your secondary drives into double density mode, and then use the 
INIT extrinsic command. 


PROBLEM PREVENTOR: Please read all the Problem Preventor notes under “How 
Do You INITialize Diskette From Command Level?". 


The only function INITDBL performs is essentially a double density version of option 
two when using the INIT extrinsic command: INITDBL reconfigures the disk drive you 
specify into double density operating mode, commands the drive to initialize your 
diskette, then INITDBL writes a copy of DOS.SYS (the DOS XL operating system file) 
onto the diskette so that the diskette is bootable, and finally reconfigures the drive 
back to single density. (Note that once INITDBL reconfigures the drive back to single 
density, the drive can no longer read the double density diskette which is in it.) Once 
INITDBL is finished, the diskette will be a bootable double density DOS XL system 
diskette, but it won't contain any of the extrinsic command files or the DOS XL menu 
program MENU.COM. (Note: "How Do You Make A Double Density DOS XL 
Diskette?" explains the creation process for a complete double density DOS XL System 
Master diskette.) 


PROBLEM PREVENTOR: The drive you specify for use with INITDBL must start 
out in single density mode; and once INITDBL has finished its work, it will return the 
drive to single density mode. This means that the drive will not be able to read the 
double density diskette it just created unless you re-CONFIGure the drive to double 
density. See "How Do You CONFIGure Drive Densities From Command Level?" for a 
discussion of the CONFIG extrinsic command, as well as a Problem Preventor note 
relating to re-CONFIGuring your first (or only) drive. 


Examples): 


With the DOS XL System Master diskette in drive one, and the default drive set to one 
(Command Processor is prompting you with "D1:"), if you type: 
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INITDBL<RETURN> 

then once the Command Processor loads and executes INITDBL.COM, INITDBL will 
then ask: 

DRIVE TO INITIALIZE? 


Assuming you only have one drive, you would type “1” for drive one followed by the 
<RETURN> key. INITDBL will then respond with: 


INSERT DISK AND HIT RETURN 


This gives you @ chance to change diskettes in the drive before initialization begins. 
Once you have the diskette to be initialized in the drive you specified, type the 
<RETURN> key and INITDBL will initialize the diskette. This process takes about 40 
seconds using an Indus GT, and possibly longer when using other manufacturers’ 
drives. When INITDBL is finished, it will automatically terminate back to the 
Command Processor. 


4.4.9 How Do You Get to the DOS XL MENU From Command Level? 


Description: 

The MENU extrinsic command provides you with a simpler, although less powerful, 
way of commanding DOS XL to do your bidding. It was designed as a way for the 
beginning user to “get acquainted" with the features of DOS XL before becoming 
swamped by the DOS's almost infinite capabilities. The MENU extrinsic command is 
all that need be issued to go from command level to the DOS XL menu. 


The entire "The DOS ‘XL Menu” section of this manual is devoted to a discussion of 
how you can use the DOS XL menu. 


Example(s): 
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With the DOS XL System Master diskette in drive one, and the default drive set to one 
(Command Processor is prompting you with "D1:"), if you type: 


MENU<RETURN> 


then once the Command Processor loads and executes MENU.COM, MENU will display 
the standard DOS XL menu: 


Files on Disk Protect Files 


To Cartridge Unprotect Files 
Copy Files Rename File 
Duplicate Disk Save Binary 
Erase Files Load Binary 


Initialize Disk Go to Address 
Xtended Command Quit to DOS XL 


The "The DOS XL Menu” section of this manual contains examples of using each one 
of the functions listed above. 


4.4.10 How Do You Initialize Your Atari 850 RS-232 Ports? 


RS232 
Command Token(s): 


None 


If you do not own an Atari 850 Interface Module, then this command is of absolutely 
no use to you. The DOS XL RS232 extrinsic command is functionaliy equivaicnt to 
Atari DOS's AUTORUN.SYS file, which attaches the R: 850 RS-232 communics:.ons 
drivers to your operating system provided it finds an 850 Interface Module attac! ) 
your Atari Computer. When the RS232 extrinsic command is executed, it loads i) « 
small piece of control software which remains in your system until you re-buot. ‘lus 
software handles the communications between your (or somebody else's) programs and 
the 850's RS-232 communication ports. This software is loaded into your computer's 
memory startling at the location pointed to by a system value called "LOMEM". Once 
the software is loaded, the value of "LOMEM" is adjusted to reflect the fact that this 
software is now resident inside your computer's memory. 
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PROBLEM PREVENTOR: [If you do not own an 850 Interface Module then yo 

need not understand this discussion at all. If you own an 850 Interface Module strictly 
for interfacing to a printer using the P: (printer) port and not the R: (RS-232) ports, 
then you need not understand this discussion. If you use software which requires th 

use of the RS-232 ports on your 850 Interface Module or you write strictly BASI 

programs which use the RS-232 ports, then you should at least understand that part of 
the discussion which deals with executing the RS-232 extrinsic command. And finally, 
if you are an assembly language programmer, then you will also need to understand th 

adjustment of the "LOMEM" memory pointer. If you are an assembly languag 

programmer, then you should also see "Using DOS XL With Assembly Language”. 


PROBLEM PREVENTOR: Due to a bug in the software contained with Atari's 85” 
Interface Module, hitting the <RESET> key will destroy the proper “LOMEM" valu: 

effectively ignoring the space occupied by the RS232 communications software. Sec 
“What About Errors in the 850's RS-232 Driver?” for a discussion of a possible 
solution to this problem. 

PROBLEM PREVENTOR: Atari's 850 Interface Module is sometimes tow 
intelligent for its own good. In particular, you cannot generally re-execute the RS232 
extrinsic command a second time without turning the 850 module off and back o 

again. This is because the RS232 extrinsic commands requires a special response fror 


the 850 module during initialization, and the 850 module will generally only provid. 
that response once after having been turned on. 


Example(s); 


With the DOS XL System Master diskette in drive one, and the default drive set to one 
(Command Processor is prompting you with “D1:"), if you type: 


RS232<RETURN> 

then once the Command Processor loads and executes RS232.COM, RS232 wi" 
initialize your 850 Interface Module, set up the resident communications driver, ar 
then terminate back to command level. 


Examples relating to the use of the RS-232 ports on your Atari 850 Interface Modul+ 
are contained in the manual which came with your 850 module. 


4.4.11 How Do You Make a Single to Double Density COPY? 
Command Syntax: 
SDCOPY <source-spec> [<target-spec>] [-[F][QUIRI[V]] 
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Command Token(s): 

<source-spec> 

This required parameter tells the SDCOPY extrinsic command the name of the file (or 
group of files if the wild-card characters “*" and/or “?" are used) which is to be copied 
to the target file(s). See "So What is a Diskette File Anyway?" for a discussion of 
wild-card characters. The parameter should not include a drive identifier since SDCOPY 
assumes you will be using drive one (see Discussion below). 


<larget-spec> 


This is an optional parameter which, if used, tells the SDCOPY extrinsic command the 
name of the file (or group of files if the wild-card characters "*" and/or "?" are used) 
which is to receive the source file(s). See "So What is a Diskette File Anyway?" for a 
discussion of wild-card characters. This parameter should not include a drive identifier 
in front of the target file name since SDCOPY assumes you will be using drive one (see 
Discussion below). If the drive identifier is not used, the default drive is assumed. If 
no target filespec if given, but a target drive identifier is given, then SDCOPY will 
assume that the target names are to be the same as the source names. If you omit the 
entire <target-spec> parameter, SDCOPY will assume you wish to copy the files 
between two different diskettes using only a single drive. The target names will be 
assumed to be the same as the source names in this case. 


-F 
Unless you specify this command option, SDCOPY will not overwrite a target file 
which already exists. 


Q 
If you specify this command option, SDCOPY will display each file before it is copied, 
and then ask you if you desire the file to be copied. 


-R 

If you specify this command option, you will be informing SDCOPY that the copy is 
to be performed from a double density diskette to a single density diskette. This is 
reverse (-R) to SDCOPY's default direction of from a single density diskette to a double 
density diskette. 


-V 

If you specify this command option, SDCOPY will produce more verbose messages as 
the copying proceeds. 

Description: 


The SDCOPY extrinsic command copies one or more files, using only drive one, from 
a single density diskette to a double density diskette (or vice versa if you specify the - 
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R command option), without making any changes in the source file(s). If you provide 
a <target-spec>, all files matching the <source-spec> will be copied to the files 
indicated by the <target-spec>. If you omit <target- spec> from the command line, 
those files indicated by the <source- spec> will be copied to files having the same 
name on the target diskette. 


PROBLEM PREVENTOR: SDCOPY cannot be used to copy between diskettes in 
two different drives. If you have more than one drive available, a far easier approach 
to copying between densities would be to CONFIGure one drive to single density, and 
the other drive to double density, and then simply use the standard COPY extrinsic 
command. SDCOPY is a specialized extrinsic command which, if you are a single drive 
user, provides you with a means of copying files between two different density 
diskettes. 


PROBLEM PREVENTOR: The SDCOPY extrinsic command should never be used to 
copy the file "DOS.SYS" onto another diskette. DOS.SYS is a special file which is 
handled in a very special way by DOS XL (in order to remain fully compatible with 
Atari's own DOS), Because of this special handling, using SDCOPY to copy DOS.SYS 
will result in the target DOS.SYS file containing two copies of the DOS.SYS file; and 
in many cases the target diskette will be unbootable. Only one of the INITialize 
extrinsic commands should be used to place a copy of DOS.SYS onto a diskette. After 
DOS.SYS has been placed onto a diskette using an INITialize extrinsic command, an 
“all files" SDCOPY can then be performed (by specifying the "*.*" file name). Since 
you will already have placed DOS.SYS on the target diskette, SDCOPY will ask if it is 
“OK to overwrite?” the DOS.SYS file. Simply answer “N" for “no”, and SDCOPY will 
move on to copying the other files. 


PROBLEM PREVENTOR: SDCOPY will not bother to ask you to “Insert ‘from’ 
disk and hit RETURN” if you answered an “OK to overwrite?" question with “N" for 
"no". Therefore, always remember to insert your "from" disk before answering this 
question with "N". SDCOPY will remember to ask you to "Insert ‘from’ disk and hit 
RETURN" after it is finished copying the file if you answered "OK to overwrite?” with 
wy. for “ves. 


Example(s): 


With the DOS XL System Master diskette in drive one, and the default drive set to one 
(Command Processor is prompting you with “D1:"), if you type: 


SDCOPY *.*<RETURN> 

then once the Command Processor loads and executes SDCOPY.COM, SDCOPY will 
begin to copy all files on the current single density diskette in the default drive to a 
double density diskette to be placed in the same drive. SDCOPY will prompt you with: 
Insert ‘to’ disk and hit return 
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when it is time to swap diskettes. When you have swapped the diskettes, press the 
<RETURN> key to tell SDCOPY that it may proceed. When SDCOPY needs you to re- 
insert the first diSkette again, it will prompt you with: 


Insert ‘from’ disk and hit return 


to which you should respond with the <RETURN> key once you've re- inserted the first 
diskette. 


PROBLEM PREVENTOR: This is the only way to copy all the information from a 
single density diskette to a double density diskette when you only have a single drive. 
Because single density diskettes and double density diskettes have different sector 
sizes, none of the DUPlicate DiSK extrinsic commands can be used to convert 
information recorded on a single density diskette to double density format. 


If you type the command: 
SDCOPY *.COM -RF<RETURN> 


SDCOPY will copy all files having an extension of ".COM" from the current double 
density diskette in drive one to a single density diskette to be placed in drive one 
when requested by SDCOPY. Note that the copy will be performed from a double 
density diskette to a single density diskette because you specified the "-R" for 
“reverse” option. If the file already exists on the single density diskette, it will be 
erased and rewritten because of your specifying the "-F" command option. 


If you type the command: 

SDCOPY C*.* -Q<RETURN> 

SDCOPY will ask you each time it finds a file starting with the letter “C" whether or 
not you wish the file to be copied from the single density diskette to the double 
density diskette. If you wish to tell SDCOPY to copy the file, you should answer with 
“Y™ for “yes” followed by the <RETURN> key. To tell COPY not to copy the file, you 
should answer with "N" for "no" followed by the <RETURN> key. 

If you type the command: 

SDCOPY TEST NEWTEST<RETURN> 

SDCOPY will copy the file "TEST" from the single density diskette to the file 
“NEWTEST" on the double density diskette. 

If you type the command: 

COPY TEST NEWTEST -R 
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COPY will copy the file "TEST" on the double density diskette to the file "NEWTEST” 
on the single density diskette which you will place into drive one when requested by 
SDCOPY. 


4.4.12 How Do You Cause DOS XL To YERIFY Or NOt VERIFY What 
It Writes? 


These utility programs allow DOS XL to write information to the disk drive in either of 
two modes. In the "VERIFY" mode, every sector written to the disk is re-read and 
compared against the sector still in the computer's memory that was intended to have 
been written. If the sector does not pass this verifying check, an error 144 is returned 
to your computer and then to your program. In the “NOVERIFY™ mode a re-read and 
compare after write is not performed. 


It should be noted that the normal write process (without VERIFY turned on) produces 
extremely reliable results -- every sector written is re-read, and, although it is not 
compared with the sector in memory, it is checked for a correct CRC value. This CRC 
value is a complex mathematic operation that is performed on the data by the disk 
drive or computer prior to writing the particular sector. The chances are much less 
than one in a million that a sector could be written incorrectly and still match its 
originally calculated CRC value. 


However, if you are running a program which is especially sensitive to data loss, or if 
you have a disk drive which is operating marginally, or if you are simply very 
cautious, you may wish to use DOS XL in the verify mode instead. To do so, simply 


type: 
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VERIFY 


in response to the “D1:" prompt. Of course, to change your mind later, you may 
simply type: 


instead. 


Of course, to use either of these commands, the files VERIFY.COM and/or 
NOVERIFY.COM must be present on the disk. So use a copy of your master disk or 
copy these files to your working disk. 
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Section 5: THE DOS XL BOOT PROCESS 


5.1 What Happens When DOS XL Is Booted? 


The process of loading the DOS XL operating system into your Atari's memory is 
somewhat different than the process for loading other DOS’s. Also, deleting or adding 
certain files to a bootable disk can affect what DOS XL will do while booting. In order 
for you to modify this process and thereby customize your system, this section 
describes the steps which are followed in the boot process. 


$5.2 What Do The DOS.SYS and DOSXL.SYS Files Do? 


While most other DOS's reside only in the DOS.SYS file on a bootable disk, DOS XL 
actually occupies two separate files. The first file, DOS.SYS must be on any disk to 
make it bootable. At the beginning of the boot process, this file is loaded into 
memory. At that time, this DOS (it is actually a complete DOS in itself) checks to see 
if an Optimized Systems Software SuperCartridge is inserted. If not, the DOS begins to 
scan for the AUTORUN.SYS file (discussed later). If a SuperCartridge is inserted, the 
DOS tries to load the DOSXL.SYS file off of the disk. If this file is found it loads over 
the top of part of the DOS. already in memory and also into a portion of the 
SuperCartridge. This newly loaded code will then become the DOS of the machine. This 
DOS saves the user SK of memory by occupying memory which is bank-switched with 
the SuperCartridge by taking advantage of special hardware within the cartridge. If you 
desire not to load this special DOS file, DOSXL.SYS, simply rename the file to a name 
other than DOSXL.SYS (perhaps SAVXL.SYS). 


NOTE: The SuperCartridge is a product of Optimized Systems Software and is available 
from your local Atari dealer. For more information concerning the SuperCartridge, you 
should contact your dealer. The DOSXL.SYS version of DOS will not Operate properly 
if Synchromesh is activated -- you can choose to take advantage of the extra storage 
that the DOSXL.SYS offers OR you can operate at Synchromesh speeds, but for the 
meantime, you cannot do both. 


$.3 What Does The AUTORUN.SYS File Do? 
Once the DOSXL.SYS file is either loaded or skipped, DOS XL searches the disk for a 
file called AUTORUN.SYS (note that there is no such file on the DOS XL master 


diskette which came with your Indus GT). If this file is found, it is loaded into memory 
just as if you had issued a “Load Binary" menu command. 
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The most common use Atari users find for the AUTORUN.SYS file is to load the RS- 
232 communications driver for their Atari 850 Interface Module into memory. Under 
DOS XL, this can be easily accomplished by simply renaming the file “RS232.COM" 
to “AUTORUN.SYS" on a copy of your DOS XL system diskette (never alter the 
original DOS XL System Master which came with your Indus GT). The RS232.COM 
file is discussed later in this manual. 


5.4 What Does The STARTUP.EXC File Do? 


If the file AUTORUN.SYS is not found, or if the program it contains returns to DOS in 
a special manner when it is completed (6502 RTS instruction), DOS XL will continue 
the boot process by searching for the file STARTUP.EXC. This file is a text file 
which contains commands for the DOS XL Command Processor to automatically 
perform. On your DOS XL System Master Diskette provided with your Indus GT there 
is a STARTUP.EXC file which contains REMark, commands for just printing messages 
to the screen, and the command MENU, which causes the Command Processor to 
automatically load and start the DOS XL menu. (A different method of automatically 
loading the command menu is discussed later.) 


PROBLEM PREVENTOR: Certain cartridge-based products, including Atari Writer 
from Atari, Inc., will not work properly if your boot disk contains a STARTUP.EXC 
file. If you are using a product such as Atari Writer, make a special boot disk as 
follows: 


1) Duplicate your master disk onto a blank one. 
2) Erase the file STARTUP.EXC on that disk. 


You should now use this disk for booting DOS XL before running Atari Writer or other 
cartridge based products which won't function correctly when using a DOS XL diskette 
which contains a STARTUP.EXC file. 


5.5 What Does The MENU.COM File Do? 


If the STARTUP.EXC file is not found, the final step of the boot process is the loading 
of the DOS XL menu, The DOS will search the disk for the file MENU.COM. If that 
file is found, it will be loaded into memory and will be given control of your Atari. If 
the Tile MENU.COM is not found, the DOS XL Command Processor will remain in 
control. Regardless of whether control is passed to the menu program or left with the 
Command Processor, if there is a cartridge inserted, final control will be given to that 
cartridge. A full discussion of the command menu program is provided earlier in this 
manual. 
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PROBLEM PREVENTOR: When you use option 2 of the [nitialj isk function 
from the DOS XL Menu, the copy of DOS XL which will be written to your newly 
initialized diskette will expect to find the menu program (MENU.COM) when the new 
diskette is booted. But, the initialization utility does pot place MENU.COM on your 
newly initialized diskette for you. In order to boot this new diskette, you must first usc 
the “Copy Files” command menu item to copy MENU.COM from one of your DOS XL 
system diskettes onto your newly initialized diskette, If you forget to do this, the new 
DOS XL diskette will start to boot but will “die” (stop working) before it says 
anything on the screen. 
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6.1 What Is The 850 Interface Module? 


The 850 Interface Module is a special communications interface produced by Atari. It 
gives your Atari computer the ability to communicate with other computer devices and 
peripherals which use standard parallel (usually printers) and RS-232 serial (many 
printers, plotters, modems, etc.) communications techniques. In order to use the RS- 
232 serial type of communications provided by Atari's 850 Interface Module, you must 
first load a special piece of software (called a “driver") into your Atari computer's 
memory. Atari DOS 2.0S automatically loads this RS-232 device driver into your Atari 
computer's memory whenever you boot DOS 2.0S. Under DOS XL, you can also cause 
the RS-232 driver to be automatically loaded when the DOS is booted, but you also 
have other options. 


If you don't happen to own an Atari 850 Interface Module, then you can save yoursclf 
some reading by skipping this section; you probably won't find it very useful. 


6.2 How Do You Load The RS-232 Driver Under DOS XL? 


When using Atari DOS 2.0S, the only way to load the RS-232 device driver (Rn:) 
contained in the 850 Interface Module is through the use of an AUTORUN.SYS file. 
This option is also available to you as a DOS XL user, as discussed earlier as part of 
the AUTORUN.SYS file. Another option is, however, available to you. After booting 
DOS XL, you can simply issue the following commands: 


1) From the DOS XL menu: 

You type: xX 

(for eXtended command) 

and then, when prompted for a command, 
You type: RS232<RETURN> 


2) Or, from the DOS XL Command Processor: 
You type: RS232<RETURN> 


Either sequence of commands will cause the RS-232 device driver which is actually 
contained within the 850 itself to be loaded into your Atari computer. You can then use 
the four RS-232 serial ports on your Atari 850 Interface Module exactly as described in 
the Atari manual which came with your 850. 

6.3 What About Errors In The 850's RS-232 Driver? 


PROBLEM PREVENTOR: Unfortunately, the device driver which loads in from the 
850 Interface Module is not perfect. The most serious flaw occurs when you push the 


193 


DOS XL for Indus GT Reference Manual 


{RESET] key after the RS-232 driver has been loaded into memory. Under certain 
circumstances, your Atari computer will “hang”, freezing the keyboard, after pressing 
the [RESET] key. For this reason, many Atari reference books recommend that you 
never press [RESET] after loading the RS-232 driver. Under DOS XL, however, there is 
a solution to this and other problems. On your master diskette which came with your 
Indus GT there is a file called "RS232FIX.COM". This file is almost identical to the 
“RS232.COM" file which is normally used to load the RS232 handler. The difference is 
that RS232FIX attempts to correct some of the known bugs in the driver when the 
driver is loaded. 


You may ask, “Why not just include RS232FIX on the DOS XL master disk and leave 
off RS232?" Well, Atari has produced several versions of the 850 Interface Module. 
Future Systems and Optimized Systems Software has almost no way of knowing 
whether RS232FIX works correctly with all 850 versions so, rather than introducing 
new problems, both the original RS232 and the modified RS232FIX are included. 


To test the "RS232FIX.COM" file with your 850 module, either: 


1) Using the DOS XL menu: 

You type: xX 

(for eXtended command) 

When prompted for a command, 
You type: RS232FIX<RETURN> 


2) Or using the DOS XL command processor: 
You type: RS232FIX<RETURN> 


If the RS-232 driver loaded in this way seems to work properly, you may use it 
exclusively for loading the RS-232 driver, ignoring the original RS232 command. 
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Section 7: SOME ADVANCED CAPABILITIES OF DOS XL 


DOS XL is capable of performing several more advanced operations than those 
discussed in the previous chapters. Most of the advanced features are only accessible 
by using the DOS XL Command Processor (they are not directly contained as part of 
the command menu). Since a few of these advanced features may be required by 
beginning DOS XL users (depending upon exactly how many and which peripheral 
devices you own for your Atari), you may want to be or need to be familiar with these 
features. In particular, if you wish to transfer files from a single density diskette to a 
double density diskette (or vice versa) and/or if you wish to use more than two disk 
drives, you should read this section. 


For most of the operations we will discuss in this section, you will be using the DOS 
XL Command Processor. As you probably recall from earlier discussions in this 
manual, you may leave the command menu and issue commands directly to the 
Command Processor by specifying the "Q" ("Quit to DOS XL") menu item. Once 
you've typed "Q" from the command menu, you will be greeted with the Command 
Processor's "D1:" prompt; as also discussed previously in this manual. (If you have 
not read these previous discussions, you should do so now.) 


PROBLEM PREVENTOR: Always remember, when using the Command Processor's 
CONFIG, INIT, COPY, and SDCOPY commands, as described below, you must have a 
DOS XL system diskette in drive 1 when you type the command. If you do not, you 
will get a "FILE NOT FOUND" error message. This message will not be referring to any 
files you may have specified as part of your command, but rather to the fact that the 
utility program which the Command Processor required could not be found on the 
diskette. 


7.1 How Do You Make A Double Density DOS XL Diskette? 

This section assumes that you were shipped DOS XL in single density only. And since 
you have only a single density copy of DOS XL, we provide here two sets of step-by- 
step instructions on how to create a double density copy of DOS XL: one set of 
instructions for menu mode and one for command processor (advanced) mode. For both 
sets, the instructions assume that you have already booted a single density DOS XL 
diskette; and that you sre using your Indus GT as drive one. NOTE: It may be possible 
to use another manufacturer's double density drive as drive one, it all depends upon how 
the other manufacturer's drive was designed (just being double density isn't enough). 
To be safe, you should use your Indus GT. 


PROBLEM PREVENTOR: Do not use your original master disk from Future 
Systems for the procecure you are about to follow. Be sure and use a copy of your 
master, instead. Since »ov may need to rename a file, you cannot have a write protect 
tab on the DOS XL diskette you use (the computer will need to write on the diskette). 
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This can be very dangerous if you are using your only copy of DOS XL, hence the need 
for using only a copy of your master disk and pever the original. 


LLLwIfl Want To Use The DOS XL Menu? 

Step 1: Boot your copy of a single density DOS XL system diskette, then type 
"MENU" followed by the <RETURN> key. This will execute the DOS XL "MENU" 
program. NOTE: The MENU program will be automatically executed if you boot a 
duplicated copy of your DOS XL diskette from Future Systems. If your computer 
responds with BASIC's READY prompt, you must type DOS and then <RETURN> to 
reach the DOS and or DOS MENU. 


Step 2: Select the “Files on Disk” menu item. DOS XL will then request “Filespec:". 
You should simply press the <RETURN> key. This step will give you a listing of all 
files on your DOS XL system diskette. 


Step 3: Examine the list of files to see if the file "DOSXL.SYS" is listed. If it isn't, 
skip ahead to Step 7. 


Step 4: Select the "Unprotect Files" menu item. DOS XL will then request “Filespec 
to unprotect:". You should respond with "DOSXL.SYS" followed by the <RETURN> 
key. This step will cause DOS XL to “unprotect" (allow you to rename or otherwise 
alter) the file "DOSXL.SYS". DOS XL has not actually altered the file, it has simply 
“unprotected” it. 


Step 5: Select the “Rename File” menu item. DOS XL will then request “Old name:". 
You should respond with "DOSXL.SYS" followed by the <RETURN> key. DOS XL will 
next request "New name:". You should respond with “"DOSXL" followed by the 
<RETURN> key. And, just to be safe, DOS XL will ask "Are You Sure?". You should 
respond with "Y" for yes followed by the <RETURN> key. This step will cause DOS 
XL to change the name of the file "DOSXL.SYS" to just "DOSXL" to insure that you 
are not running an extended memory copy of DOS XL (see Problem Preventor note 
under "How Do You Initialize a Disk From the Menu"). 


Step 6: Turn your computer's power off and then on again. This step will cause your 
computer to re-boot a standard (not extended memory) copy of DOS XL. If the copy of 
DOS XL you booted doesn't automatically execute the DOS XL menu for you, then skip 
ahead to Step 8. 


Step 7: Select the "Quit to DOS XL" menu item. DOS XL will then respond with 
"D1:". This step will cause DOS XL to terminate the menu program and leave you in 
Command Processor (advanced) mode. 


Step 8: Type “INITDBL" followed by the <RETURN> key. The INITDBL program will 
request "Drive to initialize?". You should respond with "1" for drive one and then the 
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<RETURN> key. INITDBL will then request "Insert Disk and Hit Retum". You should 
then remove your DOS XL system diskette and insert the diskette to be initialized. 
NOTE: This step will permanently erase any previous programs or data you may have 
on whatever diskette you insert (so please don’t use the diskette containing your last 
seven year's tax records). Once you have inserted a diskette, press the <RETURN> key 
to tell INITDBL to begin. This process takes about forty (40) seconds using an Indus 
GT, and longer when using most other manufacturer's drives. When INITDBL is 
finished, "D1:" will be displayed. This step will initialize a diskette in double density. 


Step 9: Remove the new double density diskette from the drive and re-insert your DOS 
XL system master diskette. Then type "SDCOPY *.* -Q” followed by the <RETURN> 
key. The first thing the program SDCOPY will do is request “Insert disk(s) to be 
copied and hit return when ready". Since you will be copying the DOS XL system 
master diskette which you already have in the drive, simply press the <RETURN> key 
to tell SDCOPY to begin. Each time SDCOPY is about to copy the next file on your 
DOS XL system master diskette, it will ask you if you wish that file copied. Since you 
wish all the files to be copied (with the exception of DOS.SYS), you should respond 
with "Y" for yes followed by the <RETURN> key. For the file DOS.SYS, respond with 
"N" for no followed by the <RETURN> key. INITDBL has already placed DOS.SYS 
onto your double density diskette, and if you tell SDCOPY to copy it, everything will 
get all messed up. DOS.SYS is the only file you should tell SDCOPY not to copy. 
SDCOPY should copy DOSXL.SYS, DOSXL.XL, and/or DOSXL.SUP (if any of them are 
present) along with any other files. Whenever you tell SDCOPY to go ahead and copy 
a file, it will sometimes request “Insert ‘to’ disk and hit return” or “Insert ‘from’ disk 
and hit return". The "to" disk is your double density diskette, and the "from" disk is 
your DOS XL system master. Whenever SDCOPY displays one of these messages, 
simply insert whichever diskette is being requested and then press the <RETURN> key. 
When the SDCOPY process has been completed, "D1:" will be displayed. This step 
copies all the files from your single density DOS XL system master diskette to your 
new double density DOS XL system master diskette. 


Step 10: Type "MENU" followed by <RETURN> to get back to the DOS XL menu. 


Step 11: If you did pot perform Steps 4 through 6 above (your "Files on disk” display 
did not contain the file “"DOSXL.SYS"), then you can skip ahead again to Step 14 at 
this point. 


Step 12: Select the "Rename File” menu item. DOS XL will request "Old Name:". You 
should respond with "DOSXL" followed by the <RETURN> key. DOS XL will then 
request "New Name:". You should respond with "DOSXL.SYS" followed by the 
<RETURN> key. And last, DOS XL will ask “Are You Sure?". You should respond 
with “Y" for yes followed by the <RETURN> key. This step will rename the file 
DOSXL back to DOSXL.SYS. 


Step 13: Select the “Protect Files” menu item. DOS XL will request “Filespec to 
Protect:". You should respond with “DOSXL.SYS" followed by the <RETURN> key. 
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This step will cause DOS XL to re-"protect" the DOSXL.SYS file from any future 
alterations (until you ask DOS XL to “unprotect” it). 


Step 14: Select the “Files on Disk" menu item. DOS XL will request "Filespec:". You 
should respond by typing just the <RETURN> key. DOS XL will then display the list 
of files on your single density DOS XL system master diskette, There are two things 
you should take note of on this display: the size (in number of sectors used) of the file 
“DOS.SYS" (this is the three digit number following the file name), and the number of 
“free sectors” which is displayed at the end of the list of file names. Remember both 
of these numbers for later. 


Step 15: Turn your Atari computer off. Remove your single density DOS XL system 
master diskette from drive one. Insert your new double density DOS XL system master 
diskette into drive one. Tum your Atari computer back on again. This step will cause 
your Atari computer to re-boot DOS XL using the double density version. 


Step 16: If, when you previously booted your single density DOS XL system master 
diskette, the menu program was automatically executed, then your new double density 
DOS XL system master diskette should also automatically execute the menu. If your 
double density DOS XL system master diskette doesn't automatically execute the DOS 
XL menu for you, you will need to type "MENU" followed by the <RETURN> key at 
this point (or type “DOS” and then <RETURN> if you were previously greeted by 
BASIC’s READY prompt). 


Step 17: If you did not perform Steps 4 through 6 above (your “Files on disk” display 
did not contain the file "DOSXL.SYS"), then you can skip ahead again to Step 22 at 
this point. 


Step 18: Select the "Rename File" menu item. DOS XL will request "Old Name:". You 
should respond with “DOSXL" followed by the <RETURN> key. DOS XL will then 
request "New Name:". You should respond with "DOSXL.SYS" followed by the 
<RETURN> key. And last, DOS XL will ask "Are You Sure?". You should respond 
with "Y" for yes followed by the <RETURN> key. This step will rename the file 
DOSXL back to DOSXL.SYS on your double density DOS XL system master diskette. 


Step 19: Select the “Protect Files” menu item. DOS XL will request "Filespec to 
Protect:". You should respond with "DOSXL.SYS" followed by the <RETURN> key. 
This step will cause DOS XL to re-"protect"” the DOSXL.SYS file from any future 
alterations (until you ask DOS XL to “unprotect” it). 


Step 20: If, at this point, you wish to re-boot your system using the extended memory 
version of DOS XL you were using before from your single density DOS XL system 
master diskette, tum your computer's power off and then on again. This step will cause 
your computer to re-boot the extended memory copy of DOS XL. If the copy of DOS 
XL you booted automatically executes the DOS XL menu for you, then skip ahead to 
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Step 22. Again, if you are greeted by BASIC’s READY prompt, typing “DOS” and then 
<RETURN> will turn control back over to DOS. 


Step 21: Type "MENU" followed by the <RETURN> key. This step will execute the 
DOS XL menu. 


Step 22: Remove your new double density diskette from the drive and place a write 
protect tab over the write protect notch!! Remember, this is your new double densily 
DOS XL system master diskette. Master diskettes should only be used to create other 
“work” diskettes on which you can place your own programs or data. You should not 
use your master diskettes as work diskettes. 


Step 23: Select the "Files on Disk" menu item. DOS XL will request “Filespec:". You 
should respond with just the <RETURN> key. DOS XL will then display all the files 
on your new double density DOS XL system master diskette. This listing will look 
just like the one from your single density diskette, with the exception of the number 
of sectors used by cach file and the number of “free sectors”. 


Step 24: Compare the number of “free sectors” on the double density “Files on Disk" 
display with the number of “free sectors” you took note of from the single density 
“Eiles on Disk" display. You now have a lot more free sectors in which to store 
programs or data. (The miracles of moder science!) 


Step 25: Compare the number of sectors used by the DOS.SYS files (the three digits 
following the file's name) with the number you took note of from the single density 
“Eiles on Disk" display. The reason why DOS.SYS uses half as many sectors on your 
double density diskette as it did on your single density diskette is because the sectors 
on your double density diskette are twice as large! This means all your files will use 
only half as many sectors on a double density diskette as they do on a single density 
diskette. So, not only does your double density DOS XL system master diskette have 
more free sectors available for use (since the files which are there are now taking up 
fewer sectors), but these free sectors can hold twice as much information. NOTE: A 
double density diskette has exactly as many sectors on it as a single density diskette, 
but double density sectors hold twice as much information as single density sectors. 
This means that only half as many double density sectors are required to hold the same 
amount of information, thus leaving more free sectors available for other information. 


Step 26: Have fun with your new double density diskette and your Indus GT! 


LL2_if 1 Want To Use The Command Processor (Advanced) Mode? 


Step 1: Boot your copy of a single density DOS XL system diskette. If the diskette 
you booted automatically executes the DOS XL menu for you, select the "Quit to DOS 
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XL” menu item in order to get back to Command Processor (advanced) mode. If you are 
greeted with BASIC’s READY prompt, type “DOS” and then <RETURN>. 


Step 2: Type “DIR” followed by the <RETURN> key. This Step will give you a 
listing of all files on your DOS XL system diskette. 


Step 3: Examine the list of files to see if the file "DOSXL.SYS" is listed. If it isn't, 
skip ahead to Step 7. 


Step 4: Type "UNP DOSXL.SYS" followed by the <RETURN> key. This step will 
cause DOS XL to “unprotect” (allow you to rename or otherwise alter) the file 
“DOSXL.SYS". DOS XL has not actually altered the file, it has simply "unprotected" 
it. 


Step 5: Type "REN DOSXL.SYS DOSXL"” followed by the <RETURN> key. This step 
will cause DOS XL to change the name of the file "DOSXL.SYS”" to just "DOSXL" to 
insure that you are not running an extended memory copy of DOS XL (see Problem 
Preventor note under "How Do You Initialize a Disk From Command Level?"). 


Step 6: Turn your computer's power off and then on again. This step will cause your 
computer to re-boot a standard (not extended memory) copy of DOS XL. If the copy of 
DOS XL you booted doesn't automatically execute the DOS XL menu for you, then skip 
ahead to Step 8. If you are greeted with BASIC’s READY prompt, typing "DOS" and 
then <RETURN> will cause you to leave BASIC and enter DOS. 


Step 7: Select the "Quit to DOS XL" menu item. DOS XL will then respond with 
“D1:". This step will cause DOS XL to terminate the menu program and leave you in 
Command Processor (advanced) mode. 


Step 8: Type "INITDBL” followed by the <RETURN> key. The INITDBL program will 
request “Drive to initialize?". You should respond with "1" for drive one and then the 
<RETURN> key. INITDBL will then request "Insert Disk and Hit Return". You should 
then remove your DOS XL system diskette and insert the diskette to be initialized. 
NOTE: This step will permanently erase any previous programs or data you may have 
on whatever diskette you insert (so please don't use the diskette containing your last 
seven year's tax records). Once you have inserted a diskette, press the <RETURN> key 
to tell INITDBL to begin. This process takes about forty (40) seconds using an Indus 
GT, and longer when using most other manufacturer's drives. When INITDBL is 
finished, “D1:" will be displayed. This step will initialize a diskette in double density. 


Step 9: Remove the new double density diskette from the drive and re-insert your DOS 
XL system master diskette. Then type "SDCOPY *.* -Q" followed by the <RETURN> 
key. The first thing the program SDCOPY will do is request “Insert disk(s) to be 
copied and hit retum when ready". Since you will be copying the DOS XL system 
master diskette which you already have in the drive, simply press the <RETURN> key 
to tell SDCOPY to begin. Each time SDCOPY is about to copy the next file on your 
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DOS XL system master diskette, it will ask you if you wish that file copied. Since you 
wish all the files to be copied (with the exception of DOS.SYS), you should respond 
with "Y" for yes followed by the <RETURN> key. For the file DOS.SYS, respond with 
"N" for no followed by the <RETURN> key. INITDBL has already placed DOS.SYS 
onto your double density diskette, and if you tell SDCOPY to copy it, everything will 
get all messed up. DOS.SYS is the only file you should tell SDCOPY not to copy. 
SDCOPY should copy DOSXL.SYS, DOSXL.XL, and/or DOSXL.SUP (if any of them are 
present) along with any other files. Whenever you tell SDCOPY to go ahead and copy 
a file, it will alternately request "Insert ‘to' disk and hit return” or "Insert ‘from’ disk 
and hit retum". The "to" disk is your double density diskette, and the “from” disk is 
your DOS XL system master. Whenever SDCOPY displays one of these messages, 
simply insert whichever diskette is being requested and then press the <RETURN> key. 
When the SDCOPY process has been completed, “D1:" will be displayed. NOTE: This 
Step can be time consuming, but you shouldn't have to do it again some other time. 
This step copies all the files from your single density DOS XL system master diskette 
to your new double density DOS XL system master diskette. 


Step 10: If you did not perform Steps 4 through 6 above (your "DIR" display did pot 
contain the file "DOSXL.SYS"), then you can skip ahead again to Step 13 at this 
point. 


Step 11: Type "REN DOSXL DOSXL.SYS" followed by the <RETURN> key. This step 
will rename the file DOSXL back to DOSXL.SYS. 


Step 12: Type "PRO DOSXL.SYS" followed by the <RETURN> key. This step will 
cause DOS XL to re-“protect" the DOSXL.SYS file from any future alterations (until you 
ask DOS XL to “unprotect” it). 


Step 13: Type “DIR" followed by the <RETURN> key. DOS XL will then display the 
list of files on your single density DOS XL system master diskette. There are two 
things you should take note of on this display: the size (in number of sectors used) of 
the file "DOS.SYS" (this is the three digit number following the file name), and the 
number of “free sectors" which is displayed at the end of the list of file names. 
Remember both of these numbers for later. 


Step 14: Turn your Atari computer off. Remove your single density DOS XL system 
master diskette from drive one, Insert your new double density DOS XL system master 
diskette into drive one. Turn your Atari computer back on again. This Step will cause 
your Atari computer to re-boot DOS XL using the double density version. 


Step 15: If, when you previously booted your single density DOS XL system master 
diskette, the menu program wasn't automatically executed, then your new double 
density DOS XL system master diskette shouldn't automatically execute the menu. If 
your double density DOS XL system master diskette does automatically execute the DOS 
XL menu for you, you will need to select the “Quit to DOS XL” menu item. (If your 
screen shows READY, type "DOS" and then <RETURN>). 
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Step 16: If you did not perform Steps 4 through 6 above (your "DIR" display did pot 
contain the file “DOSXL.SYS"), then you can skip ahead again to Step 20 at this 
point, 


Step 17: Type "REN DOSXL DOSXL.SYS" followed by the <RETURN> key. This step 
will rename the file DOSXL back to DOSXL.SYS on your double density DOS XL 
system master diskette. 


Step 18: Type "PRO DOSXL.SYS" followed by the <RETURN> key. This step will 
cause DOS XL to re-"protect" the DOSXL-.SYS file from any future alterations (until you 
ask DOS XL to “unprotect” it). 


Step 19: If, at this point, you wish to re-boot your system using the extended memory 
version of DOS XL you were using before from your single density DOS XL system 
master diskette, turn your computer's power off and then on again. This step will cause 
your computer to re-boot the extended memory copy of DOS XL. If the copy of DOS 
XL you booted automatically executes the DOS XL menu for you, then you will need to 
select the "Quit to DOS XL" menu item. (A READY message on your screen can be 
replaced by DOS prompts by typing "DOS" and then <RETURN>). 


Step 20: Remove your new double density diskette from the drive and place a write 
protect tab over the write protect notch!! Remember, this is your new double density 
DOS XL system master diskette. Master diskettes should only be used to create other 
“work” diskettes on which you can place your own programs or data. You should not 
use your master diskettes as work diskettes. 


Step 21: Type “DIR” followed by the <RETURN> key. DOS XL will then display all 
the files on your new double density DOS XL system master diskette. This listing will 
look just like the one from your single density diskette, with the exception of the 
number of sectors used by each file and the number of "free sectors”. 


Step 22: Compare the number of “free sectors" on the double density "DIR" display 
with the number of “free sectors" you took note of from the single density “DIR" 
display. You now have a lot more free sectors in which to store programs or data. 
(The miracles of modem science!) 


Step 23: Compare the number of sectors used by the DOS.SYS files (the three digits 
following the file's name) with the number you took note of from the single density 
“DIR" display. The reason why DOS.SYS uses half as many sectors on your double 
density diskette as it did on your single density diskette is because the sectors on your 
double density diskette are twice as large! This means all your files will use only half 
as many sectors on a double density diskette as they do on a single density diskette. 
So, not only does your double density DOS XL system master diskette have more free 
sectors available for use (since the files which are there are now taking up fewer 
sectors), but these free sectors can hold twice as much information. NOTE: A double 
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density diskette has exactly as many sectors on it as a single density diskette, but 
double density sectors hold twice as much information as single density sectors. This 
means that only half as many double density sectors are required to hold the same 
amount of information, thus leaving more free sectors available for other information. 


Step 24: Have fun with your new double density diskette and your Indus GT!! 


7.2. How Do You Use Two Drives in Different Densities? 


DOS XL version 2.351 is compatible with and capable of controlling any mixture of up 
to eight single density and/or double density (Indus GT) disk drives. If you have once 
or more drives only capable of single density (such as Atari's 810 or, when under DOS 
XL version 2.351, Atari's 1050) as well as one or more Indus GT's capable of double 
density operation, we would suggest that you connect your double density Indus GT 
drive as drive 2 while creating your first double density DOS XL system diskette, and 
then as drive 1 for long- term usage. (See your Indus GT Owners Manual for switch 
settings, etc.). The long-term setup will allow you to boot DOS XL in either single or 


double density mode. 


Although your Indus GT drive is capable of either single or double density operation, 
you can generally predict which density it will be in when power to your Atari 
computer is turned on. If it is drive 1, it will automatically acquire the density of the 
DOS XL diskette you are booting. If it is other than drive 1, your Indus GT will use the 
following rules to determine which density it is operating under, with rule 1 being first 
priority: 

1) If there is a diskette in the drive, it will automatically change (if necessary) to 


ate in the density of that diskette when it receives its first command from DOS XL. 
(The only exception to this is if the first command is to format the diskette.) 


2) If there is no diskette in the drive, but there has been a diskette read or written 
(accessed) by that drive since the drive was tured on, the drive will remain in the 
density of the last diskette which was accessed. 


3) If the drive has not accessed a diskette since it was turned on, it will default to using 
the density switch setting on the back of the drive. (See your Indus GT Owners 


Manual.) 


PROBLEM PREVENTOR: Since rule 3 is last priority for your Indus GT in 
determining the density under which it will be operating, you can see that the switch 
on the back of the Indus GT is certainly pot a “force the density” switch. The diskette 
currently in the drive, or the diskette which was last in the drive, has more influence 
over the drive's operating density than the back pancl switch. 


203 


a 





DOS XL for Indus GT Reference Manual 


There are, of course, no switches to be set on single density only drives like the Atari 
810 or, in the case of using DOS XL and even Atari DOS 2.0S, the Atari 1050 drive. 


DOS XL as shipped is sect up to handle one or two disk drives and up to three 
simultaneously open files in double density mode (i.e., Three BASIC “OPEN” 
Statements without an intervening "CLOSE"). If you own three or more disk drives, or 
you require more files open at one lime, you must change some of the settings 
contained within DOS XL. This is discussed later in this manual. 


While booting, DOS XL automatically asks each drive the density under which the 
drive is operating. From then on, if you want to change a drive's density (by changing 
the diskette in the drive to one of a different density), you must use the CONFIG 
command from DOS XL's Command Processor. You should never use the front panel 
buttons to change the Indus GT's operating density since this will not notify DOS XL 
that a change has occurred. 


CONFIG has several advanced options, which are discussed elsewhere in this manual. 
For our purposes, however, we need to learn three of its abilities before going on. 
Remember, the following commands must be performed using the Command Processor 
and not the menu, so you will have to use "Q" to get out of the menu first. 


1. If you wish to find out what density DOS XL believes each drive is, following the 
Command Processor prompt: 


Di: 

You type: CONFIG<RETURN> 

The table which is printed will tell you the density under which each disk drive is 
operating as well as other information regarding your drives. If a drive is not capable 
of double density operation, it is noted as “can't configure". Up to cight drives will be 
reported, and the system will even tell you which drives you don't have. 


2. If you wish to change a drive from single to double density, following the 
Command Processor prompt: 


Di: 

You Type: CONFIG 1D<RETURN> 

or you type: CONFIG 2D<RETURN> 

or any other drive number which you wish to change. 


In general, you specify the drive number you want to configure and then use a "D" to 
indicate double density. Any configurable drive may be changed this way. When 
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CONFIG does its thing, it will also print the complete drive table to show you the 
change. If you first set your Indus GT to display the drive's type information (use the 
“DRIVE TYPE" button on the front of your Indus GT), you will be able to see the drive 
change from type “A” (single density, or “Atari 810 emulation mode") to type “b” 
(lower case "B” for double density, or “Atari 815 emulation mode"). 


PROBLEM PREVENTOR: If you use CONFIG to change the density of the drive in 
which you have your DOS XL system diskette, then the drive will no longer be able to 
read that diskette. Since CONFIG is a program which DOS XL must load off the 
diskette in order to change the drive's density back to its original density, this will 
cause you a problem unless you have already created a copy of your DOS XL diskette in 
the correct density. Essentially this means that you should wait to try this little 
CONFIG trick until you read through this entire discussion. 


3. If you wish to change a drive from double to single density, following the 
Command Processor's prompt: 


Di: 

You Type: CONFIG 1S<RETURN> 

or you type: CONFIG 2S<RETURN> 

In general, you specify the drive number you want to configure and then use an “S" to 


indicate Single density, Any configurable drive may be changed this way. Just like 
when changing to double density, CONFIG will print a new drive table. 


7.3 How Do You Initialize Different Density Diskettes? 


As was noted in the previous discussion concerning the “Initialize Disk” menu item, 
that menu item should only be used to initialize a disk which is the same density as 
the booted master disk (or the current operating density of whichever drive is being 
used for the diskette initialization). Using the Command Processor, however, there 
are several other possibilities, And there is one exception. 


1. If you have a single drive system, you may initialize a double density disketle even 
if you have booted a single density master (as is the case with the DOS XL System 
Master which came with your Indus GT). To do so, following the Command Processor 
prompt: 

Di: 


You Type: INITDBL<RETURN> 
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INITDBL is a Command Processor command which, when it has loaded from the DOS 
XL master disk, will simply ask you which drive you wish to use (presumably 1, in 
this case). It will then automatically configure the drive to double density, format the 
diskette, write DOS.SYS to the diskette, and then reconfigure the drive back to single 
density. 


PROBLEM PREVENTOR: Do not use INITDBL when you have booted a double 
density master disk. Use menu option “I” instead. 


2. If you have a multiple drive system, you may use CONFIG to configure drive 2 (or 3 
or any other drive) to the density you desire. Then, following the Command Processor 
prompt: 


D1: 
You Type: INIT<RETURN> 


and the INIT utility will load and run, presenting choices identical to those presented 
by the "I" menu option. Or, following the Command Processor prompt: 


D1: 
You Type: MENU<RETURN> 


and the DOS XL menu will be reloaded and reactivated, and you may then use menu 
option "I". The actual rule is that you may initialize any diskette to the density of the 
drive it is placed in. 


7.4 How Do You Copy Between Densitles With Only One Indus GT? 


This section applies only to those with one drive and that drive must be an Indus GT. 
If you have two or more drives, see the next section, 


If you would like to copy one or more files from a single density diskette to a double 
density diskette (or vice versa), you must first have a diskette which has been 
formatted (initialized) to the proper density. If you do not have such a diskette, we 
suggest that you read the discussion above for assistance in initializing such a 
diskette. 

Then, after having used the “Q” 
Processor prompt: 


option of the menu, and following the Command 


D1: 
you type: 
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SDCOPY DI:*.* D1:*.* -Q<RETURN> 
or you type: 
SDCOPY DI1:*.* D1:*.* -QR<RETURN> 


The first form will copy files from single to double density. ‘The second form will copy 
files from double to single density. 


SDCOPY will load in and then allow you to place your source ("from") diskette (in case 
its not the system diskette already in the drive) in the drive. SDCOPY will then read 
the directory of the source disk and give you a chance to say Yes or No about cach file 
in the directory. If you answer Yes, the file will be copied to your destination (“to”) 
disk. Since you have only a single drive, you will have io swap diskettes at least once 
for each file (long files may require two or three swaps). SDCOPY will tell you when 
it needs the diskettes to be swapped. 


SUGGESTION: Remove any cartridges from your Atari if you are copying any large 
files. This may allow SDCOPY to copy these files in fewer swaps, since the cartridge 
space can then be used by SDCOPY. (This docs not apply to Optimized Systems 
Software's SuperCartridges, which already automatically release their space to DOS XL.) 


7.5 How Do You Copy Between Densities Using Two Drives? 


If you own two or more drives, you may instead use the standard “Copy Files” 
command (option "C" of the menu) to transfer files between single and double density. 
First, however, you must ensure that your drives are appropriatcly configured. 


Since you presumably have booted your double density master diskette on drive 1, we 
suggest that you use “CONFIG 2S” (discussed above) to place drive 2 in single density 
mode (unnecessary, of course, if drive 2 is an Atari 810 Disk Drive, since it is always 
single density). 


Remember, in order to use option "C” (for Copy) after using CONFIG, you must follow 
the Command Processor prompt: 


Di: 

with the command: MENU<RETURN> 

This will command the Command Processor to reload the DOS XL menu and reactivate 
it. You may then choose option "C". When asked for “from” and “to” file names, be 
sure and specify "D1:" and "D2:", as appropriate. (If you make a mistake, Copy will 
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probably not find the file names you are looking for, so no harm will be done. Just 
reverse the drive specifiers and try again.) 


PROBLEM PREVENTOR: You may pot use menu option "D" (Duplicate disk) to 
copy from a double density to single density diskette or vice versa! Strange and 
disastrous things will occur if you attempt to do so. Duplicated disks are literally 
duplicates, including the fact that the densities must be the same. 


7.6 What Do You Do If You Have More Than Two Drives? 


DOS XL, as it is shipped with your Indus GT, is set up to handle one or two disk drives 
and up to three simultaneously open files in double density mode (i.e., three BASIC 
“OPEN” statements without an intervening “CLOSE"). If you own three or more disk 
drives, or you require more files open at one time, you must change some of your 
DOS XL's default settings. DOS XL refers to the default setting associated with the 
number of drives you own as DRVBYT (you don't need to understand these names). 


The default setting referred to as DRVBYT controls how many drives to which your 
DOS XL is willing to talk. DRVBYT is set to the value 3 (this doesn't mean three 
drives) on the DOS XL diskette which came with your Indus GT. 


The following table gives the values to which DRVBYT will need to be changed in 
order to use more drives: 


Value __ Number of Drives 
1 1 Only 
3 lor2 
7 1tw3 
15 lw4 
31 lw 5 
63 1w6 
127 l1w7 
255 1 8 


Before you can change the DRVBYT value, you will need to create a new DOS XL 
system diskette (if you haven't already done so) which can be updated with the new 
value. Never alter the DOS XL System Master Diskette which came with your Indus 
GT. 


Problem Preventor: The BASIC cartridge, like some other cartridges, have some 
conflicts when a STARTUP.EXC file exists on the copy of DOS that is booted into the 
computer's memory (this is true even if the BASIC cartridge is already built into your 
computer -- as with the 600XL and 800XL models). The following instructions may 
not work unless the copy of DOS which you boot prior to performing these steps is 
free of any STARTUP.EXC files. 
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cc 


In order to change the DRVBYT value, perform the following steps (this requires an 
Atari BASIC cartridge): 


1) Turn you Atari computer's power off. 


2) Insert your Atari BASIC cartridge into your computer (do pot use Optimized Systems 
Software's BASIC XL). Boot your DOS XL master disk. 


3) Insert the copy you made of your DOS XL System Master Diskette into drive 1. 
4) Turn your computer on to boot DOS XL. 


5) If your system disk stops booting at the command menu, terminate the menu 
program by specifying the “Quit to DOS XL” command, 


6) Tell DOS XL to transfer control to the Atari BASIC cartridge by typing the 
Command Processor command “"CAR<RETURN>". 


7) After Atari BASIC gives you its "READY™ prompt, type “"POKE 1802,#<RETURN>"; 
where “#" in that typing sequence is one of the numbers from the table listed above. 


8) Press your computer's [RESET] key. 


9) After Atari BASIC responds with "READY", type "DOS<RETURN>". This will return 
control to DOS XL. 


10) To get back to the DOS XL menu, following the "D1:" Command Processor 
prompt, type "MENU<RETURN>". 


11) From the DOS XL menu, specify the “Initialize Disk” menu item. 


12) When the INIT utility displays your four diskette initialization options, type 
"3<RETURN>" to specify the "WRITE DOS.SYS ONLY” option. 


13) When the INIT utility asks you to "ENTER DRIVE (1,2,3 OR 4):", type 
"1<RETURN>" to specify that the modified DOS.SYS file is to be written to the 
diskette in drive 1. 


14) The INIT utility will confirm your selections by displaying "FUNCTION 3; DRIVE 
1" and "ARE YOU SURE (Y OR N):". If all this is correct, type "Y<RETURN>" to tell 
INIT to proceed. If you typed something wrong, type "NcRETURN>" and INIT will 
return you to the list of options. 


15) Once you've typed “Y<RETURN>", INIT will write your modified copy of DOS XL 
to the DOS.SYS file on drive 1. To confirm that everything went correctly, tum your 
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Atari computer off and then on again to reboot the new modified DOS XL. Once DOS 
XL is rebooted, you should be able to access as many drives as you selected from the 
above table. 


7.7 How Do You Increase The Number Of Files You Can Have Open? 


Using the copy of DOS XL which came with you Indus GT, you may open at the same 
time up to six single density files, or up to three double density files. If this setting is 
not enough for your needs, you will need to change one of DOS XL's default settings. 
DOS XL refers to this default setting as SABYTE (you don't need to understand this 
name). SABYTE is set to 6 on the copy of DOS XL which came with your Indus GT. 
The following table lists other possible values to which you can change SABYTE: 


Problem Preventor: The BASIC cartridge, like some other cartridges, have some 
conflicts when a STARTUP.EXC file exists on the copy of DOS that is booted into the 
computer's memory (this is true even if the BASIC cartridge is already built into your 
computer -- as with the 600XL and 800XL models). The following instructions may 
not work unless the copy of DOS which you boot prior to performing these steps is 
free of any STARTUP.EXC files. 


SABYTE Files Open in _ Files Open in 
Vv : < : 
y | 2 1 
4 4 2 
6 6 3 
8 - 4 
10 -- 5 
12 -- 6 


Changing the value of SABYTE is almost identical to changing the value of DRVBYT 
as discussed above. The only difference is that for step 7 you would do: 


7) After Atari BASIC gives you its "READY" prompt, type "POKE 1801,#<RETURN>"; 
where “#" in that typing sequence is one of the numbers from the table listed above. 
NOTE: The only difference between step 7 for changing DRVBYT and step 7 for 
changing SABYTE is that for DRVBYT the number after “POKE” is "1802", while the 
number after "POKE” when changing SABYTE is "180]". 
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Section 8: USING DOS XL WITH THE ATARI BASIC CARTRIDGE 


This section discusses how to use your Indus GT disk drive and DOS XL from your Atari 
BASIC cartridge. This section is pot intended as any kind of tutorial on how to use 
Atari BASIC or how to program in BASIC. Your Atari BASIC cartridge should have 
come with both a tutorial book which teaches you how to program in BASIC, and also 
a reference manual which lists cach BASIC command and how it is used. This manual 
only includes the following discussion to explain how the same BASIC statements 
discussed in Atari's own manuals can be used to access files and information stored on 
your Indus GT diskette drive. The following discussion assumes you are already 
familiar with the information which Atari provides in their BASIC manuals, 


But first, let's get the hardware set up right and things put in their proper places, Right 
off, you should have a copy of your DOS XL System Master Diskette which came with 
your Indus GT. Don't_use your original diskette!! Take your copied master diskette and 
put it in drive 1, turn you Atari computer off, put your BASIC cartridge in the left 
cartridge slot, and tum the power on again. 


Since you should be using a successful copy of the master disk by this point, we'll 
assume that the system booted properly (if it didn't, try everything again with a new 
blank diskette before calling us). 


When DOS XL finishes booting and presents you with the DOS XL menu, you should 
select the “To Cartridge” menu item. When you do so, you should sce BASIC’s familiar 
"READY" prompt, and all is well. 


Suppose, though, that you wanted to return to the DOS XL command menu. Why would 
you want to do that? Well, from the DOS XL menu you can list all files on a diskette, 
erase large collections of files, protecl/unprotect large collections of files, and so on, 
without losing any BASIC program that you might have already typed in. 


In fact, many of the menu commands (discussed earlier in this manual) may be used 
without harming even a line of what you may have typed in while in BASIC. To get 
back to your program just select "To Cartridge”. You will be back in BASIC, and any 
program you might have written in is still there. 


PROBLEM PREVENTOR: If you select any of the following menu items, you will 
lose any BASIC program you may have in memory: 


Copy Files 
Duplicate Disk 
Initialize Disk 
Xtended Command 
Load Binary 
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If you need to perform any of these commands, save your BASIC program to disk prior 
to returning t© the menu from BASIC. 


So, from the DOS XL menu, “To Cartridge” will put you in BASIC (make sure the 
cartridge is there first), Nice and neat. But how do we get from BASIC back to the 
DOS XL menu? Simple: Following BASIC's "READY" prompt, type "DOS<RETURN>". 
This will return you to the DOS XL menu or command processor. 


The following sections discuss the most common BASIC commands and statements 
which affect files on the disk. Please note that these commands should be issued while 
using the BASIC cartridge. That is, these commands should be typed only as part of a 
BASIC program or immediately after BASIC’s “READY” prompt. 


When the usage of the statement is being shown, the "{", "}", “[", and “]" characters 
are used to surround sections of the statement which are optional (not required). A "...” 
following a section of the statement infers that that section can be repeated zero or 
more times. 


8.1 How Does BASIC's "CLOSE" Statement Work With DOS XL? 
Statement: CLOSE 

Purpose: This command writes any information which has been kept in memory and 
which is intended for the specified file to be written to the diskette, and then 


disassociates the file number (channel) and file which were associated by a previous 
OPEN statement. 


Usage: CLOSE #fn 
Arguments: “fn” - file number (1-7) 
Description: 


After CLOSEing a file number, the user may no longer perform reads or writes (e.g, via 
PRINT, INPUT, etc.) on the file which had been associated with that channel. 


PROBLEM PREVENTOR: A file OPENed for any form of output (modes 8, 9, or 12) 
should always be closed before the diskette containing it is removed or changed. The 
most common cause of crashed (no longer usable) Atari diskettes is failure to observe 
this rule. 


HINT: Atari BASIC does pot consider it an error to CLOSE a channel that is not 


OPEN, so it is often good practice to end a program segment by a line such as the 
following: 
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999 FOR I=1 TO 7 : CLOSE #I : NEXT I 


NOTE: Both the END and RUN statements close all files (except file #0, which is used 
for keyboard and screen reads and writes), and can be used to advantage for this purpose 
when desired. 


8.2 How Does BASIC's "ENTER" Statement Work With DOS XL? 
Statement: ENTER 


Purpose: This command is used to retrieve a BASIC program that has been LISTed to 
the disk. 


Usage: ENTER filespec 
Argument: "filespec” -- the name of the file you are going to ENTER. 
Description: 


The ENTER statement is used to retrieve a BASIC program that has been LISTed to the 
disk. As the program is being ENTERed into BASIC’s user area, each line will be 
checked for proper syntax and converted into the internal (tokenized) form used by 
BASIC. 


If a syntax error is encountered, the offending line will be listed with the suspected 
error location in inverse video, 


NOTE: The line with the error will, nevertheless, be placed in program memory. In 
such a case, your program must be corrected before you can RUN it. 


PROBLEM PREVENTOR: ENTER does pot clear the user memory space. Therefore, 
if you wish to ENTER a new program, use NEW first. (Actually, this can be a handy 
feature when you wish to merge two programs together.) 


Example: 


You: 10PRINT “THIS IS PROGRAM 1" 
LIST "D:PROG1" 

10 PRINT “THIS IS PROGRAM 2" 

LIST "D:PROG2" 

NEW 

ENTER "D:PROG1" 

LST 


BASIC: 10 PRINT “THIS IS PROGRAM 1" 
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You: NEW 
ENTER "D:PROG2" 4a 
RUN 


BASIC: THIS IS PROGRAM 2 


8.3 How Does BASIC's "GET" Statement Work With DOS XL? 


Statement: GET 


Purpose: This statement will retrieve a single byte of data from a specified previously 
OPENed disk file. 


Usage: GET #fn,avar 


Arguments: "fn" -- file number (1-7) 
"“avar" - any numeric variable 


Description: 


The GET statement is used to retrieve a single byte of data from a disk file that has 
been previously OPENed using the same file number which you specify on the GET 
statement. 


NOTE: The data that you are GETting from the disk file should have been previously 
written to the specified file using the PUT statement. 


Example program: 


10 OPEN #1,8,0,"D:TEST" : REM CREATE A TEST FILE 
20 FOR I = 0 TO 255 : PUT #1, :NEXT I 

30 CLOSE #1 :REM WE CREATED IT 

40 OPEN #1,4,0,"D:TEST™ : REM NOW CHECK IT OUT 
50 FOR I = 0 TO 255 : GET #1,X : REM CHECK EACH 

60 IF X <> 1 THEN PRINT “BAD DISK DATA",I,X 

70 NEXT I 

80 END: REM END CLOSES ALL FILES 


8.4 How Does BASIC's "INPUT" Statement Work With DOS XL? 


Statement: INPUT 
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Purpose: This command is used to request data from the specified file number (or 
keyboard). 


Usage: INPUT {#fn,} var {,var...} 


Arguments: "fn" -- file number (1-7) 
“var" -- either numeric or string variable 


Description: 


When the INPUT statement is used without the “fn” option, data will be requested from 
the keyboard. You will notice a "?" appearing on the screen prompting you for the 
keyboard input. See your Atari BASIC Reference Manual for more details. 


When the file number (#fn) argument is used, data will come in the form of ATASCII 
lines from the file that has been previously successfully OPENed using the same file 
number. Otherwise, the action of INPUT is virtually identical to the action when 
INPUTing data from the keyboard. That is, a string input is terminated by an ATASCII 
RETURN character and a numeric input by either the RETURN or a comma within a 
line. 


NOTE: The INPUT statement cannot (generally) read a line that is longer than 127 
characters in length. If you PRINT a line to the disk that you will later want to INPUT, 
it is best to limit the size of the PRINTed line to 127 characters or less. 


Example program: 


10 DIM LINES(15) 

20 OPEN #1,8,0,"D1:INPUT.SMP" : REM CREATE A FILE 
30 FOR I = 1 TO 20 

40 PRINT #1;"THIS IS LINE #";1 : REM WRITE THE DATA 
50 NEXT I 

60 CLOSE #1 : REM CLOSE THE FILE YOU JUST CREATED 
70 OPEN #1,4,0,"D1:INPUT.SMP” : OPEN FOR READ ONLY 
80 FOR I = 1 TO 20 

90 INPUT #1,LINES : REM GET THE FIRST LINE 

100 IF LINES(15) <> STRS(I) THEN GOTO 500 

110 PRINT LINES 

120 NEXT I 

130 CLOSE #1 : REM CLOSE THE FILE 

140 PRINT "SUCCESSFUL# USE OF THE INPUT STMT" 

150 STOP 

500 REM WE GET HERE FROM LINE 100 

510 PRINT "UNSUCCESSFUL USE OF INPUT" 

520 END: REM ANOTHER WAY TO CLOSE THE FILE 
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8.5 How Does BASIC's "LIST" Statement Work With DOS XL? 


Statement: LIST 


Purpose: This command will LIST the program currently in memory to the screen (or to 
the file specified). 


Usage: LIST [filespec] 
or: LIST [filespec,] linenol [,lineno2]} 


Arguments: “filespec” -- the name of the file you are going to LIST to the disk. 
“linenol” -- beginning line number 

“lineno2" -- ending line number 

Description: 


The LIST command is probably one of the most commonly used commands in BASIC. 
Most people know that the LIST command, when given all by itself, will LIST their 
program to the screen. Even when beginning and ending line numbers are given the 
results are predictable. 


Now with DOS XL the LIST command can do even more. When used with a filespec, 
the LIST command will LIST your program to the disk instead of the screen. The 


contents of this file will contain text characters and can take up a large amount of disk 
space if you have a large program. 


If vou use the option where two line numbers are given, then only the lines from 
linenol to lineno2 (inclusive) will be LISTed to the filespec. 


If you use the option where only one line number is given, then only that line will be 
LISTed to the filespec. 


HINT: The ability to LIST a range of lines to the disk provides a convenient method 
of moving a subroutine (for example) to another program. 


See also the ENTER statement discussion. 


8.6 How Does BASIC's "LOAD" Statement Work With DOS XL? 
Statement: LOAD 


Purpose: This command will get a program that has been SAVEd to the disk and put it 
in BASIC's memory. 
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Usage: LOAD filespec 


Arguments: “filespec” -- The name of the file you wish to LOAD. 


Description: 

LOAD is used in conjunction with the BASIC SAVE command. Only programs which 
have been previously SAVEd to disk may be LOADed. No syntax checking will be done 
as your program is being LOADed, because the program is already in internal format. 
Generally, if you wish to keep a program on the disk, you SAVE it. Then, later, when 
you wish to look at it, modify it, or RUN it, you can LOAD it. BASIC does not 
remember the name that you use when you LOAD a program, so you can SAVE it again 
either under the same name (in which case the original version is replaced by the new 
version) or under another name. 


Also, see the RUN command for an alternative method of LOADing a program which 
will simply be RUN and not modified. 


Example: 

You: 10 PRINT “THIS IS PROGRAM 1" 
SAVE "D:PROG1" 

10 PRINT "THIS IS PROGRAM 2” 

SAVE "D:PROG2" 

LOAD "D:PROG1" 

LIST 

BASIC: 10 PRINT "THIS IS PROGRAM 1" 
You: RUN "D:PROG2" 


BASIC: THIS IS PROGRAM 2 


8.7 How Does BASIC's "OPEN" Statement Work With DOS XL? 
Statement: OPEN 
Purpose: This command prepares a file for access and assigns it a file number. 


Usage: OPEN #fn,aexp] ,aexp2,filespec 
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Arguments: "fn" -- file number (1-7) 

“aexpl" -- Read or Write (Inpu’Output) Mode: 
4 = input 

6 = directory access 

8 = oulput 


9 « append 
12 = inpuVoutput 


“aexp2” -- device dependent value (usually 0) 
“filespec” -- a proper DOS XL file name 


Description: 


The OPEN statement allows a disk file (or any device, for that matter) to be linked to a 
file number (channel) for future reference in connection with file input/output 
instructions (¢.g., PUT, GET, INPUT, PRINT, CLOSE). 


Comments on arguments: 

The "fn" argument allows for a number between 1 and 7. The number 0 is reserved for 
the screen and can not be used in Atari BASIC. After a file has been OPENed with a 
given "fn", all references to that file must be made using that same “fn”. 


The “aexp1" argument allows the user to OPEN a file for a specific “mode”, according 
to the following table: 


Mode 4: will OPEN the specified file for input only. ‘hus you can only retrieve 
data from the specified file. 


Mo.'. 6: allows you to access the directory on the disk. 


Mode 8: is the opposite of mode 4. That is, data can only be stored to the specified 
file. See below for notes when using mode 8. 


Mode 9: is used to add data to the specified file. The data that is added will begin at 
the current end of the specified file. 


Mode 12: is used to access the specified file for input and output. Thus data can be 
Stored and retrieved from the specified file. 


PROBLEM PREVENTOR: After OPENing a file, the specified file number must be 
used to designate the file in other inpuVoutput statements. Two OPENed files cannot 
have the same file number, but it is possible to OPEN the same file with two different 
file numbers. Generally, such a double OPEN will have disastrous results. 
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NOTE: If a file is OPENed for output (aexpl=8) and the specified file does not exist 
then a file with the specified name will be created for you. If the file specified already 
exists, it will be destroyed and a new file with the specified mame will be created for 
you. 


PROBLEM PREVENTOR: A file OPENed for update (acxpl«12) can pot be 
appended to under DOS XL or Atari DOS 2.0S. Only files opened in mode 9 wil! allow 
a file's size to be increased. . 


HINT: Mode 6 might, for example, be used from BASIC to find what files are on 4 
disk and thereby allow a menu selection. The following program will allow a menu 
selection of all BASIC SAVEd programs on drive 1, providing that the program names 
do not have an extension (i.c., the programs should not have been SAVEd as 
“D:name.ext” but simply as "D:name"). 


Example program: 


100 OPEN #1,6,0,"D:*" : DIM LNS(40) 
110 FOR I = 1 TO 20: INPUT #1, LNS 
120 IF LNS(2,2)=" " THEN PRINT I,LNS(3,10) : NEXT I 
130 CLOSE #1 : OPEN #1,6,0,"D:*" 
140 PRINT : PRINT “WHAT PROGRAM TO RUN *; 
150 INPUT J : IF J>=1 THEN GOTO 140 
160 FOR l= 1 TO J: INPUT #1,LNS : NEXT | 
7 170 CLOSE #1 : LNS$(1,2) = “D:" 
180 RUN LNS(1,10) 


_ = S|: h6LAaL) he 


Try typing this in and then saying SAVE “D:MENU". Later, you can use the program 
L by typing RUN "D:MENU". 


PROBLEM PREVENTOR: As shipped by Future Systems, your DOS XL will allow 
only six single density files or three double density files to be OPEN at one time. See 
q oar 7.7 (above) for "How Do You Increase The Number Of Files You Can Have 
n?". 
L 8.8 How Does BASIC's "PRINT" Statement Work With DOS XL? 
Statement: PRINT 
Purpose: This command puts the ASCII equivalents of the given expressions to the file 
L specified on the screen. 
Usage: PRINT [#fn {;}] exp [{,}exp...] {,} 


[ Arguments: "fn" -- file number (1-7) 
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‘exp" -- the expression can either be a string enclosed in double quotes, a string 
variable, or a numeric variable. 


Description: 


When a file number is used with the PRINT command, the specified variables are 
PRINTed to the disk file that has been previously OPENed using the same file number. 


NOTE: Characters are PRINTed to a disk file in a manner identical to the way 
characters are PRINTed to the screen if the file number option is not used. 


PROBLEM PREVENTOR: A "," after the #fn causes tabbing before the first 
character is PRINTed. A ";" does not cause the tabbing. Normally, the semicolon 
should be used. 


See also INPUT. 


8.9 How Does BASIC's "PUT" Statement Work With DOS XL? 

Statement: PUT 

Purpose: This statement is used to store a single byte of data to a specified file. 
Usage: PUT #fn,avar 

Arguments: “fn” -- file number (1-7) 

“avar" -- an arithmetic variable 

Description: 

The PUT statement is used to output a single byte of data to a specified file. The file 
number used in the PUT statement must be one that has been previously used in the 
successful OPEN of a file. 


PROBLEM PREVENTOR: Data that has been stored in a file using the PUT 
statement can usually only be retrieved using the GET statement. 


See also GET. 
8.10 How Does BASIC's "SAVE" Statement Work With DOS XL? 
Statement: SAVE 
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Purpose: This command will store a BASIC Program on disk in internal format (not 
ATASCII). 


Usage: SAVE filespec 

Arguments: “filespec" -- filename you wish to SAVE your program under (remember, a 
proper filespec includes the device specifier D: or DI:, etc. when the file is to be read 
from or written to a disk drive). 


Description: 


The SAVE command is used to SAVE your BASIC program in its internal format, This 
format is usually smaller than the text form of your program and will take up less room 


on your disk. All programs SAVEd to the disk must be reentered using the LOAD or 
RUN commands. 


See descriptions of LOAD and RUN for more examples and further explanations. 


8.11 How Does BASIC's "XIO" Statement Work With DOS XL? 


Statement: XIO 


Purpose: This is BASIC’s catch-all InpuvOutput command. If BASIC doesn't provide a 
function to access a particular feature of a device or file, some form of XIO can 
probably be used to do so, 


Usage: XIO subcommand,#{n,aux1,aux2,filespec 

Arguments: “command” -- see descriptions below. 

“fn" -- a file number. In contrast to most DOS XL read/write commands, XIO often 
requires that the file number be that of an un-OPENed channel. The XIO command 
dictates the usage here, so see descriptions below. 

“auxl" and “aux2" -- generally zero. These values are passed to DOS XL unchanged (and 
thence to the device being accessed), so the individual device(s) may require other 
values. None of the examples given in this section use these values. 

“filespec” -- a proper DOS XL file name. 

Description: 

Although, as noted, XIO can be used for Several purposes, we will restrict our 


discussion here to those four XIO commands most useful to the Atari BASIC 
programmer. 
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The XIO commands to be discussed will each be treated as separate BASIC statements. 


8.12 How Do You Rename A File From Atari BASIC? * 
X1O Command: 32 (Rename) 
Purpose: May be used to rename disk files. 
Usage: XIO 32,#fn,0,0,filespec 
Arguments: "fn" -- the file number of an un-OPENed channel. 
“filespec” -- a proper DOS XL file name followed by, in the same BASIC String, a 
comma and a second file name. The second file name may not include a disk drive 
specifier, 
Description: 
It is suggested that "fn", the file number, be 7, since that channel is normally reserved 
for system read/write functions (which this certainly is). The only thing strange about 
this XIO command is the form of the filespec. Some examples follow: 

XIO 32,#7,0,0,"D:TEST.SAV,OLDTEST.SAV" 

DIM FLS(100) 

INPUT FLS 

FLS(LEN(FLS)+1) = ",BACKUP" 

XIO 32,#7,0,0,FLS 
Again, note that the second file name in both examples is not preceded by a disk drive 
specifier. 
8.13 How Do You Erase A File From Atari BASIC? 
XIO Command: 33 (Erase/Kill/Delete) 
Purpose: May be used to permanently eras: disk files. 
Usage: XIO 33,#fn,0,0,filespec 


Arguments: "fn" -- the file number of an un-OPENed channel. 
filespec™ -- a proper DOS XL file name, with “wild cards" accepted and processed. 


Description: 
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If the file specified exists on the disk drive speci‘ied, anc jf the file is not 


PROTECTED (see next XIO command), the specified file will be permanently erased 
(deleted, killed, zapped) from the disk. 


USE THIS XIO SUBCOMMAND WITH CAUTION: sp. cifying a “wild card” (a 
file name including an asterisk or question mark) will erase ill files which match the 
given name. 

Examples: 

XIO 33,#7,0,0,"D2:OLDPROG.SA V" 


will erase the single file with the name OLDPROG.SAV from the diskette wu drive 
a. 


XIO 33,#5,0,0,"D:*.BAK" 

will erase all files having a filename extension of "BAK" { n the diskette in drive 1. 
8.14 How Do You Protect Files From Atari RASIt? 

XIO Command: 35 (Protect/Lock) 

Purpose: May be used to protect disk files from a idental erasure and modification. 
Usage: XIO 35,#fn,0,0,filespec 


Arguments: "fn" -- the file number of an un-OPE?-.< channel. 
“filespec” -- a proper DOS XL file name, with "wild cards" accepted and processed. 


Description: 


All files on the specified drive which have name, which match the specified file will 
be "PROTECTED" by usage of this XIO command. Protection in the DOS XL 
environment simply consists of setting a flag 1) the diskette's file directory which 
tells the DOS to disallow either modification (ic , OPENs in modes 8, 9, 12, etc.) or 
erasure of the file. Any DOS XL DiRectory listing will show protected files by means 
of an asterisk in the first column of the displayed lines (unprotected files have simply 
@ space in that position). 


Examples: 


XIO 35,#7,0,0,"D:*.*" 
will protect ALL files on drive 1. 


XIO 35,#1,0,0,"D4:DOS.SYS" : 
will protect only the file named “"DOS.SYS" on the diskette in drive 4. 
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8.15 How Do You Unprotect Files From Atarl BASIC? 


XIO Command: 36 (Unprotect/Ualock) 


Purpose; May be used te unprotect.disk files to allow subsequent erasure and 
modification. 


Usage: XIO 36,#fn,0,0,filespec 


Arguments: "fn" -- the file number of an un-OPENed channel. 
“filespec" -- a proper DOS XL file name, with "wild cards" accepted and processed. 
Description: 


All files on the specified drive which have names which match the specified file will 
be "UNPROTECTED" by usage of this XIO command. Protection in the DOS XL 
environment simply consists of setting a flag in the diskette’s file directory which 
tells the DOS to disallow either modification (i.e, OPENs in modes 8, 9, 12, etc.) or 
erasure of the file. Any DOS XL DiRectory listing will show UNprotected files by 
means of a space in the first column of the displayed lines (protected files have an 
asterisk in that position). 


Examples: 


XIO 36,#7,0,0,"D2:*.COM" 
will unprotect all files on drive 1 which have a filename extension of ".COM". 


XIO 36,#1,0,0,"D1:DOS.SYS" 

will unprotect only the file named “DOS.SYS" on the diskette in drive 1 (this 
step is necessary before erasing that file, as you might do to gain more space on the 
diskette). 


8.16 How De You Automatically Run BASIC When DOS XL is Booted? 


DOS XL is capable of booting directly into a BASIC program. In order to do so, you 
must perform a few simp erations, which are presented in step-by-step fashion 
below: 


Step 1: Boot a DOS XL master diskette. If the diskette you booted automatically 
executes the DOS XL menu, select the “Quit to DOS XL" menu item. 


Step 2: If you want the BASIC program to start running when you boot another 
diskette rather than the one you just booted, place the other diskette in the drive at 
this time. NOTE: If the diskette is not initialized, refer to “How Do You Initialize a 
Disk From Command Leve!?". 
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Step 3: Type "TYPE E: STARTUP.EXC” followed by the <RETURN> key. DOS XL 
will blank out the screen and then the cursor will appear at the upper left corer of the 
screen, In the following line which you will type, the “basprog” part is a fictitious 
file name which should be replaced by the name of the BASIC program you wish to be 
executed. Type: DO CAR;RUN"D:basprog” followed by the <RETURN> key. NOTE: 
The double quotes (") should be typed as part of the line for this particular line. Also 
NOTE: whichever BASIC program you specify in substitution for “basprog” must be 
SAVEd onto this diskette before trying to boot this disketle. Now hold down the 
<CONTROL> or <CTRL> key and then type "3". This tells DOS XL that you are 
finished typing stuff to be placed into the file STARTUP.EXC. 


NOTE: This file can also be created from the DOS XL menu by Copying from E: to 
D:STARTUP.EXC and using the same CTRL-3 to indicate when you've completed the E: 
entry. NOTE: See "What Does the STARTUP.EXC File Do?" and "Controlling DOS XL 
Without Being There" for an explanation of the STARTUP.EXC file you have just 
created. 


Step 4: Type “DIR” followed by the <RETURN> key. Check the "DIR" listing to 
make sure all of the following files are listed: DOS.SYS, DO.COM, ST. ARTUP.EXC, and 
the BASIC program which you specified in the line you typed above. If ahy of these 
files are missing, your diskette will not boot correctly. If DO.COM is missing, see 
“How Do You Copy Files From Command Level” for an explanation of how to copy it 
from your DOS XL master to this diskette. If your BASIC program is on a different 
diskette, get into Atari cartridge BASIC and “LOAD” the program from the diskette it is 
on and then "SAVE" it to this diskette (sce "How Do You Go to a Cartridge From 
Command Level” and "Using DOS XL with the Atari BASIC Cartridge"). DOS.SYS 
should have been placed onto the diskette when you initialized the diskette, and 
STARTUP.EXC should be there since you just typed it in the previous step. 


Step 5: Last, but not least, before trying to re-boot using this newly created diskette, 
make sure your Atari BASIC cartridge is installed correctly, 


Step 6: Turn your Atari computer's power off and then on again to re-boot using this 
new diskette. 
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Section 9: CONTROLLING DOS XL WITHOUT BEING THERE 


9.1 So What is DOS XL Batch Processing Anyway? 


Once you've become experienced using DOS XL and are actually using it to perform 
some serious tasks for you, you may often find yourself repeating the same group of 
Command Processor commands over and over. In such a case, you can place these 
commands into a “batch” or “execute” file; and then later tell DOS XL, in a single 
quick command, to execute all the commands which you have placed into this file. 
This can save quite a bit of your time and energy since you won't constantly be typing 
the same sequence of commands. 


Let's suppose that you wrote several programs that had to be run in sequence. Without 
using a batch file, you could issue the Command Processor commands necessary to run 
each program one at a time. If each program in the sequence took a long time to run, 
you would probably find yourself sitting at the keyboard for hours waiting for each 
program to finish just so you could type the command(s) necessary to get the next 
program running. ° 


But, since you'ld probably rather go watch television, take a nap, or something while 
your Atari does all your work for you (what are computers for, anyway?), having a 
batch file issue those commands to DOS XL when necessary would probably be more to 
your liking. 


All you would need to do in order for you to go off and have fun while your computer 
Slaves away is to create a batch file containing the DOS XL commands required to run 
your set of programs. You would then enter the one command which tells DOS XL to 
take the rest of its commands from that batch file while you go off for your nap. 


Any text file with the filename extension ".EXC" can be used as a DOS XL batch 
execute file. You tell DOS XL to start taking its commands from your batch file in 
much the same way as you give DOS XL an extrinsic command. The only difference is 
that you precede the batch file's name (do not include the ".EXC" extension) with the 
commercial "at" symbol ("« ). For example, if you had already prepared a batch file 
called "DEMO.EXC" on drive one, and your default drive was on, you would type: 


@DEMO<RETURN> 


to tell DOS XL to begin taking its commands from the file "DEMO.EXC". When you 
give this command to DOS XL, the Command Processor will attempt to open the file 
“D1:DEMO.EXC" and then set up DOS XL to read it line by line, executing the 
Command Processor commands contained within the file just as if you were typing 
them from the keyboard. 


226 


— Pere Fe Fer FF EP 


DOS XL for Indus GT Reference Manual 
9.2 What Is Contained In a DOS XL Batch ".EXC" File? 


An “execute” or “batch” file is simply a text file. Each line of this text file will 
become a command to the Command Processor when you tell the Command Processor 
to “execute” the batch file. 


There are just three simple rules you must follow when you are creating each line of the 
batch file: 


1) The line must contain a valid DOS XL Console Processor command. 
2) The line must be shorter than 128 characters in length. 


3) The line must end in a standard Atari carriage return character (ATASCII $9B 
hexadecimal, see your Atari manual). 


DOS XL allows the commands in an execute file to be preceded by numbers and blanks. 
This feature allows the command lines to be numbered for readability and to document 
their purposes, This means that the command file lines: 


LOAD OBJ.TEST<RETURN> 
and: 
100 LOAD OBJ.TEST<RETURN> 


are the same to DOS XL. The Command Processor will search the line for the first 
non-numeric, non-blank character before starting to examine the command itself. 
Almost any text editor, including program editors supplicd with many languages (such 
as MAC/65 from Optimized Systems Software), can be used to create and modify 
execute files. 


PROBLEM PREVENTOR: It is not possible to use the Atari BASIC cartridge’s 
program editing mode to edit an execute file. 


SPECIAL NOTE: You may also create an execute file (or, for that matter, any text 
file) by using the Command Processor intrinsic command “TYP E: <file-name>". The 
TYPe command will clear the screen, at which time you simply type in your text, line 
by line. When you are finished typing all the lines of your texVexecute file, you hold 
down the <CONTROL> or <CTRL> key and type the "3" key in order to tell DOS XL 
you are finished. Although this approach will work, it is difficult to use since, once 
you press <RETURN> at the end of a line, you cannot go back to that line and make 
any changes. Although the cursor movement keys on your Atari keyboard will appear 
to function correctly while you enter your text, you can only make corrections w the 
current line you are typing without making a mess of your text file. 
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9.3 What Commands are Special for Batch Files? 


DOS XL has four special intrinsic commands designed for use exclusively with execute 
files. These commands are: 


REMARK Remark or comment (does nothing) 

SCREEN Turn on the echoing of execute file command lines to the 
screen. (This is the default.) 

NOSCREEN Turn off echoing of execute file command lines. 

END Stop executing the execute file and return DOS XL to keyboard 
entry mode. 


A more detailed discussion of these commands is provided under "The DOS XL 
Command Processor" sections of this manual. 


9.4 How Is a Batch File Stopped? 


While an execute file is being processed, various conditions may occur which will 
warrant a halt in the batch execution. These conditions may occur because of system- 
detected errors or because of a user program detecting a condition it considers hazardous 
to the system's health. 


9.4.1 ..by DOS XL? 


Humans are not quite perfect in the eyes of computers and sometimes make mistakes. 
If DOS XL detects an error in a human specified command, DOS XL will respond with 
an error message. If DOS XL discovers such an error while processing an execute file, 
it will print the error message as usual and then stop executing the execute file. Note 
tha this stopping due to an error only occurs if the error is found by DOS XL, not if a 
pregram detects an error. 


Execution of an execute file will also stop after the CARtridge command is executed. 


Finally, execution of course stops when the end of the execute file is reached since 
there are no more commands to be taken from the file. 


9.4.2 ..by a Program? 


PROBLEM PREVENTOR: The following discussion is intended for 
assembly/machine language, BASIC, and/or other language programmers. If you do 
not use your Atari for programming, or if the programs you write have no need to stop 
a batch file from executing, then you need not understand the following section. 
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It is sometimes desirable for a program in a chain of executing programs to stop the 
execute process. The usual reason for this is that the program has detected an error 
severe enough that the programs which follow it in the chain should no longer be 
executed. There is a flag kept in a special memory location by DOS XL which tells 
DOS XL that it is supposed to be taking its commands fr\.m an execute file. If a 
program sets this special memory location to the value z'9, then DOS XL will no 
longer “remember” it is taking its commands from an exec u'e file and will therefore 
resume taking commands from the keyboard. The execute flay is located 12 bytes from 
the starting location of DOS XL within your Atari's memory. The starting location of 
DOS XL is contained within the 6502 word memory location 10 (SOA). The following 
BASIC program segment will turn off the execute file and return to DOS XL- 


1000 DOSLOC = PEEK(11)*256+PEEK(10) : REM DOSLOC - DOS'S START ADDRESS 
1010 EXCFLG = DOSLOC+11 : REM EXCFLG = EXECUTE FL. {G'S ADDRESS 

1020 POKE EXCFLG,0: REM SET DOS'S FXFCUiE FLAG T() ZERO 

1030 DOS : REM RETURN TO Dus XL 


Or, from Optimized Systems’ BASIC XL, you could simply us> 
100 POKE DPEEK(10)+11,0 : DOS 


(Remember, though, that a CARtridge command automatically stops ".EXC” file 
execution, so this example may not be useful from ASIC.) 


9.5 What is Special About the STARTUP.FXC Batch File? 


The execute file "STARTUP.EXC" has special meanings to DOS XL. When DOS XL is 
first booted (when you turn on your Atari), DOS XL will search the directory of the 
booted diskette for a file named STARTUP.EXC. [!f STARTUP.EXC is on the booted 
diskette, DOS XL will execute that file before requesting keyboard commands. 


A more detailed discussion of the "STARTUP.EXC” file is provided under “What Does 
The STARTUP.EXC File Do?”. 


9.6 How Do Execute Files Work? 


PROBLEM PREVENTOR: The following sectson deals with programmer subject 
matter and may not be suitable for persons who still retain their sanity. As a result, 
Future Systems recommends that if sane (non-programmer) people are still reading this 
section at this point, they should skip the remainder of this section. Thank you. 


When you type in the Command Processor command "@<file-name>", the Command 


Processor actually stores the <file-name> in an internal storage location (CPEXFN) and 
sets a flag (CPEXFL) to indicate that a batch operation is in progress. 
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Each time the Command Processcr prompts the user (with “D1:", “D2:", etc.) it checks 
this flag to see if a batch executiun is active. If so, it opens the batch file (using the 
stored <file-name>). Unless this is the first time the batch file has been opened (again, 
kept track of via a bit in CPEXFL)}, the Command Processor POINTS to the start of the 
next text line in the file. 


The next text line is then read into the command buffer. Then the Command Processor 
NOTEs the new position in the file and saves the position (CPEXNP) for use by the 
next needed POINT process (as above). 


Finally, the command in the command buffer is executed just as if the user had typed it 
from the keyboard. If the command properly terminates (via an RTS or a JMP through 
DOSVEC), the entire process repeats, until the execute flag is somehow turned off. 


The experienced programmer will no doubt realize that changing the contents of the 
various CPEXxx locations can affect batch execution in possibly very interesting 
ways, These locations are all defined in the file called SYSEQU.ASM and are offsets 
from the address contained in DOSVEC (location $O00A). See, as an example, the 
sample program segment given above which stops the execution of a batch file, 


Some of this information is further discussed under “Using DOS XL with Assembly 
Language”. 
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Section 10: USING DOS XL WITH ASSEMBLY LANGUAGE 


; 
PROBLEM PREVENTOR: This entire section contains extremely technical 
information relating to the interfacing of assembly/machine language programs to DOS 

L XL. If you are not an assembly/machine language programmer, you will have 
absolutely no need in the world to understand the following discussion. If you are a 
beginning assembly/machine language programmer, this is noi the place to start when 
learning assembly/machine language. All of the following information is intended for 

L the experienced assembly language programmer, and no atiempt has been made to 
“soften” the discussion in order to accommodate users who have no experience with the 
type of information being discussed. 


SPECIAL NOTE: The information contained in this section has been supplied by 
Future Systems as a courtesy to those users who “wanted to know”. Unfortunately, this 
information relates to performing operations which are far beyond the needs of the 
vast majority of DOS XL users; and therefore any questions arising from the use of the 
information contained in this section would be in the extreme minority. Because of 
the unbalanced nature of normal user support versus technic. advanced user support, 
very little support can be provided by Indus for those users who have trouble with the 
_ information contained in this section. Should you encounter problems with the 
_ information in this section, Future Systems will attempt to assist you as best as we 
can; but in general you should consider yourself “on your own". 


DOS XL is designed as a layered operating system. Application programs including 
__ languages such as BASIC XL) are expected to call the operating system “properly”, 
~ through the system call vector (labeled "CIO" in the file "SYSEQU.ASM” on your DOS 
XL System Master diskette). In turn, the CIO will determine which device is to receive 
__ what I/O request and handles most of the work transparent to the calling program. 
| 
“Ife program restricts itself to proper calls to CIO using labels provided in 
SYSEQU.ASM, the program should transfer virtually without change from one version 
of DOS XL to another. (Probably the only other areas of change would involve 


__ memory map usage.) 
In any case, herewith is a description of the proper assembly language calling 


sequences and parameters under DOS XL. 
10.1 Interfacing to I/O Routines 
_ 10.1.1 The Structure of the IOCB's 


When a program calls the OS through location “CIO”, OS expects to be given the 
address of a properly formatted [OCB (Input Output Control Block). For simplicity, we 
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have predefined 8 IOCB’s, each 16 bytes long, and the calling program specifies which _ 
one to use by passing the IOCB oumber times 16 in the 6502's X-register. Thus, to 
access IOCB number four, the X-register should contain $40 on entry to OS. Notice 
that the IOCB number corresponds directly to the file number in BASIC (as in PRINT 
#6, etc.). The IOCB's are located from $0340 to $03BF on the Atari (but you really 
should use the equates from the disk file "SYSEQU.ASM" rather than relying on hard- 
coded addresses.) 


When the OS gets control, it uses the X-register to inspect the appropriate IOCB and 
determine just what it was that the user wanted done. Figure 10-1 gives the DOS XL 
standard name for each field in the [OCB along with a short description of the purpose 
of the field. Study the figure before proceeding. 


The user program should never touch fields ICHID, ICDNO, ICSTA and ICPUT, as they 
are set by the OS. In addition, unless the particular device and I/O request requires it, 
the program should not change ICAUX1 through ICAUX6. The most important field is 
the one-byte command code, ICCOM, which tells the operating system what function 
is desired. 
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IOCB Structure 
Offset Size 


Within of 
_ eta IOCB_ Field 
ame (bytes) (bytes) Purpose of Field 





t by OS. X into device nace table for currently 
open file, set to $FF if no file c»2n on this IOCB. 
1 1 Set by OS. Device number (e.g, ; for "D1:xxx" or 2 for 
“D2:yyy") 
_ccom 2 1 The command request from user program. Defines how 
rest of IOCB is formatted. 

'CSTA 3 1 Set by OS. Last status returned by device. Not 
necessarily the status returned via STATUS command 
request. 

ICBADR 4 2 Buffer Address. A two byte address in normal 6502 

low/high order. Specifies address of buffer for data 
L transfer or address of filesaame f JPEN, STATUS, etc. 
ICPUT 6 2 Set by OS. Address minus one of device's put-one-byte 


routine. Possibly usefu! when high speed single byte 
needed, 


L transfers are R 

CBLEN 8 2 Buffer length. Specifies maximum number of bytes to 
transfer for PUT/GET operations. Note: this length is 
decremented by one for each byte transferred. 


; 

eaux 10 1 Auxiliary byte number one. Used in OPEN to specify 
kind of file access needed. Some drivers can make 
additional use of this byte. 


| cauxe 11 1 Auxiliary byte number two. Some serial port functions 
may use this byte. Thiy and all following AUX bytes are 
for special use by each device driver. 


_CAUX3 12 2 For disk files only: where the ICAUX4 disk sector 
number is passed by NOTE and POINT. (These bytes 
could be used separately by other drivers. 


CAUXS 14 1 For disk files only: the byte-within- sector number 
passed by NOTE and POINT. 
ICAUX6 15 1 A spare Auxiliary byte 
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IOCB Field Usage - Standard Commands 
eo S16 TTS Fie 
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ICB- ¥ U 
ICB- SYSEQU.ASM) 
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CNOTE 
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LEGEND: "“*" Set by OS when this command Is used. 
"Bul" Address of a data buffer. 
“Fname” Address of a file name. 
"len" Length of a data buffer. 
"md" Mode of OPEN (read, write, etc.) 
"secno” Sector number (see “The VO Commands"). 
“by” By‘r im sector (see “The VO Commands"). 


234 


iz 
5 

Eel ge al Se tod Teg * Bel & oea= 9 

Le] sf Pelee lest eae [ee Tl oemmeme 

Bey) pay BSsl ide Secleaz f30 ch Be ee Ss 

Ae ee ee ee ee 


IOCE 


DOS XL for Indus GT Reference Manual 
10.1.2 The I/O Commands 


The preceding tables provide a summary of the I/O commands and the associated usage 
of the various fields of the IOCB's. The first seven are DOS XL oriented and will be 
dealt with in "The Standard DOS XL Commands” discussion izlow. The last six are 
File Manager specific and are discussed in “Commands Unique *> the Disk File Manager 
System". 


Most of the commands manipulate a device in some way, s» maybe we should talk 

about them for a moment. Device names under DOS XL ar: very simplistic; they 

consist of a single letter optionally followed by a single digit used to define a specific 

device when more than one of the same kind exist (for example, DI: 0: D2:) 

Traditionally (and, in the case of Atari disk files, of necessity) the device name 1: 

followed by a colon. The following devices are implemented under standard DOS XL 
[ and Atari DOS: 


E: The keyboard/screen editor device. ine normal console cuiput. 
K: The keyboard alone. Use this device to bypass editing of user input. 
S: The sercen alone. Can be either characters (ala E:) or graphics. 
L P: On the Atari, the printer. The standard device driver all. only one printer. 
C: The cassette recorder. 
D: The disk file manager, which also usually requires a file name. 


Other device names are possible (for RS-232 interfaces, for example), and in fact the 
case with which other devices may be added is another mark for the claim that DOS XL 
is a true operating system. (The structure of device drivers is material for a later 
section.) But we should like to point out that, on the Atari, the OS ROM includes 

[ drivers for all the above except the disk. In fact, the drivers account for over 5K bytes 
of the ROM code. The screen handler, with all its associated editing and GRAPHICS 
modes, occupies about 3K bytes of that. 


EF The Standard DOS XL Commands 


The OS itself only understands a few fundamental commands, but DOS XL also provides 
for the extended commands necessary to some devices (XIO in BASIC). In any case, 
each of these fundamental commands deserves a short description. 


L 
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10.1.2.1.1 OPEN 


Open a device (synonyms: file, IOCB, channel) for read and/or write access. OS 
expects ICAUX1 to contain a byte that specifies the mode of access: 


ICAUX1 MODE 

4 Read Only 

6 Read Directory Only 
8 Write Only 

4 Write Only Append 

12 Read/Write (Update) 


The name of the device (and, for the disk, the file) must be given to OS; this is 
accomplished by placing the ADDFESS of a string containing the name in ICBADR. 


10.1.2.1.2 CLOSE 


Terminate access to a device/file. Only the command must be given. 


10.1.2.1.3 STATUS 


Request the status of a device/file. The device can interpret this request as it wishes, 
and pass back a (hopefully) meaningful status. As with OPEN, the ADDRESS of a 
filename must be placed in ICBADR 


10.1.2.1.4 GET TEXT 


A powerful command, this causes the OS to retrieve ("GET") bytes one at a time from a 
device/file already OPENed unti! either the buffer space provided by the user is 
exhausted or a RETURN character (Atari $9B) is encountered. The user specifies the 
buffer to use by placing its ADDRESS in ICBADR and its maximum size (length) in 
ICBLEN. 


10.1.2.1.5 PUT TEXT 


The analogue of GET TEXT, OS outputs characters one at a time until a RETURN is 
encountered or the buffe; is empty. Requires ICBADR and ICBLEN to be specified. 
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10.1.2.1.6 GET DATA 


Extremely flexible command, this causes OS to retrieve, from the device/file previously 
OPENed, the number of bytes specified by ICBLEN into the buffer specified by 
ICBADR. No checks what-so-ever are performed on the contents of the transferred 
data, 


10.1.2.1.7 PUT DATA 


Er 


Similar to GET DATA, except that OS will output ICBLEN bytes from the buffer 
specified by ICBADR . Again, no data checks are performed. 


L 10.1.2.2 Commands Unique to the Disk File Manager System 


The second part of the "IOCB Field Usage” tables shows several DOS XL system 
| commands not yet discussed. These “extended” commands are accessed via the extended 
_ fequest routine in a device driver's handler table (see “Device Handlers” for details on 
“ device drivers). However, some of these extended commar as implemented for the 
disk device in the File Manager System are important enough to deserve their own 
) sections. We'll examine each of the extended disk operations in a little detail: 

10.1.2.2.1 ERASE, PROTECT, and UNPROTECT 

Also known as Delete, Lock, and Unlock, these three commands simply provide OS 

with a channel number (i.e., the X-register contains IOCB number times 16), a 

command number (ICCOM), and a filename (via ICBADR). When OS passes control to 

the FMS, an attempt is made to satisfy the request. Note that the filename may include 


“wild cards", as in "D:*.??S" (which will affect all files on disk drive one which have 
an ‘S' as the last letter of their filename extension). 


_10.1.2.2.2 RENAME 
Very similar to ERASE, et al, in usage. The only difference is in the form of the 
filename. Proper form is: "[Dn:Joldname.ext,newname.ext" Note that the disk device 
_ specifier is not and CAN NOT be given twice. 
10.1.2.2.3 NOTE and POINT 
Other than OPEN, these are the only commands encountered in standard DOS XL which 


use any of the AUXiliary bytes of the IOCB. Fer these commands, the user specifies 
the channel number and command number and then receives or passes file pointer 
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information via three of the AUX bytes. ICAUX3/ICAUX4 are used as a conventional 
6502 LSB/MSB 16-bit integer: they specify the current (NOTE) or the to- be-made- 
current (POINT) sector within an already OPENed disk file. ICAUXS is similarly the 
current (NOTE) or to-be-made-current (POINT) byte within that sector. 


10.1.2.3 FMS Extensions of the OPEN Command 


Open is not truly an extended operation, but for disk /O we need to know that the 
FMS allows two additional “modes” beyond the fundamental OS modes. 


If ICAUX1 contains a 6 when DOS XL is called for OPEN, then the disk directory is 
opened (instead of a file) for read-orly access. The address ICBADR now specifies the 
file (or files, if wild cards are used) w be listed as part of a directory listing. Note that 
FMS expects this type of OPEN to be followed by a succession of GETREC (get text 
line) OS calls. 


If ICAUX1 contains a 9, the specified file is opened as a write-only file, but the file 
pointer is set to the current end-of-file. 


10.1.3 Error Codes Returned 


On return from any OS call, the Y-register contains the completion code of the 
requested operation. A code of one (1) indicates “normal status, everything is okay”. 
(I know, why not zero, which is easier to check for. Remember, we based this on 
Atari's OS ROMs, which are good, not perfect.) By convention, codes from $02 to $7F 
(2 through 127 decimal) are presumed to be “warnings”. Those from $80 to $FF (128 
through 255 decimal) are “hard” errors, These choices facilitate the following 
assembly language sequence: 


JSR CIOV ; call the OS 
TYA ; check error code BMI 
OOPS ; if $80-SFF, it must be an error 


In theory, DOS XL always returns to the user with condition codes set such that the 
TYA is unnecessary. In practice, that's probably true: but a little paranoia often leads 
to longer life of both humans and programs. 


10.2 Manipulation of DOS XL 
The writer of assembly language code will most likely need to interface with the Atari 
Operating System (OS) in some way. If the assembly code is to become an extrinsic 


command, there may be o need to interface to DOS XL. Sce “Interface to I/O Routines” 
for more information abcu' the OS interface. 


238 





c— 


cc 





DOS XL for Indus GT Reference Manual 


If you are writing software designed to interface with DOS XL, you may need to 
examine and/or modify certain special memory locations or access certain routines 
within DOS XL. This section lists and describes those that we feel are the most useful. 


10.2.1 SYSEQU.ASM 


Every DOS XL master disk contains an assembler source file, SYSEQU.ASM, that has 
various commonly used Atari OS and DOS XL system equates. This file may be 
included in an assembly language program via the OSS MAC/65 include function 
(.INCLUDE #D1:SYSEQU.ASM); however, it exists on the master disk as a text file and 
must be "ENTER'ed into MAC/65 and then 'SAVE'ed back to the disk. 


10.2.2 CP MEMORY LOCATIONS 


The Command Processor (CP) on the Atari is designed to be placed just after the 
normal Atari File Manager when the DOS.SYS version of DOS XL is used. Since the 
actual location of CP may vary with different versions of the file manager and/or 
because of different memory configurations, a fixed location has been assigned to 
point to CP. The location CPALOC (SOA on the Atari) contains the address of the 
DOS XL and CP warmstart entry point. Most Atari programs should return to CP by 
JMPing to the address contained in CPALOC. 


10.2.3 EXECUTE PARAMETERS 


The CP execute flag is located CPEXFL (SOB) from the start of CP. The CPALOC may 
be used as an indirect pointer to access the execute flag: 


IDY #CPEXFL ;GET DISPL TO FLAG 
LDA (CPALOC),Y {LOAD FLAG 


The Execute Flag has four bits that control the execute process: 


Name Bit# Description 


EXCYES $80 If one, an execute is in progress 

EXCSCR $40 If one, do not echo execute input to screen 

EXCSUP $20 If one, a cold start execute is starting. Used to avoid a FILE NOT 
FOUND error if STARTUP.EXC is not on boot disk. 

EXCNEW $10 If one, a new execute is starting. Tells CP to start with the first 
line of the file 
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CP performs the execute function by OPENing the file, POINTing to the next line, 
READing that line, NOTEing the new next line and CLOSEing the file. To perform 
these functions, CP must save the execute file name and the three byte NOTE values. 
The filename is saved at CPEXFN (SOC) into CP. The three NOTE values are saved at 
CPEXNP (SIC) into CP. (CPEXNP = ICAUXS; CPEXNP + 1 = ICAUX4; CPEXNP + 2 = 
ICAUX3). By changing the various execute control parameters, a programmer can 
cause chaining of execute files, skipping of certain lines in the file, etc. 


10.2.4 DEFAULT DRIVE LOCATION 


The CP default drive file spec is located at CPDFDV ($07) into OS/A+. The Default 
Drive here is ATASCII Dn: where "n" is the ATASCII default drive number. 


10.2.5 EXTRINSIC PARAMETERS 


The extrinsic commands may be called with parameters typed on the command line. 
The CP command: 


D1:COPY FROMFILE D2:TOFILE 


is an example of this. The entire command line is saved in the CP input buffer located 
at CPCMDB ($3F) bytes into CP and is available to the user. Since most command 
Parameters are file names, CP provides a means of extracting these parameters as 
filenames. The routine that performs this service begins at CPGNFN ($03) bytes into 
CP . The routine will get the next parameter and move it to the filename buffer at 
CPFNAM ($21) bytes in CP. If the parameter does not contain a device prefix, then 
CP will prefix the parameter with the default drive prefix. The first time COPY calls 
CPGNEN the file spec “D1:FROMFILE” is placed at CPFNAM. The second time COPY 
calls CPGNFN the file spec "D2:TO FILE” is placed in CPFNAM. If CPGNEFN were to 
be called more times, then the default file spec would be set into CPFNAM at each call. 
To detect the end of parameter condition, the user may check the CPBUFP (SOA into 
CP) cell. If CPBUFP does not change often a CPGNEN call then there are no more 
parameters. The filename buffer is always padded to 16 bytes with ATASCII EOL ($9B) 
characters. The following example sets up a vector for calling the get file name 
routine: y 


CLC 

LDA CPALOC ;ADD CPGNFN 

ADC #CPGNFN ;TO CPALOC VALUE 

STA GETFN+1 ;AND PLACE IN 

LDA CPALOC+1 ;ADDRESS FIELD 

ADC #0 ;OF JUMP 

STA GETFN+2 ;INSTRUCTION 
GETFN JMP 0 
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The following routine gets the next file name to CPFNAM: 


LDY #CPBUFP SAVE CPBUFP 

LDA (CPALOC),Y ;VALUE 

PHA 

JSR GETFN iGET NEXT FILE PARM 
LDY #CPBUFP 

PLA ;TEST FOR NO NEXT 
CMP (CPALOC),Y ;PARM 

BEQ NONEXT ;BR IF NO NEXTPARM 
LDY #CPFNAM ;ELSE GET FILE 


LDA (CPALOC),Y ;NAME FROM BUFFER 


10.2.6 RUNLOC 


Whenever an extrinsic command is invoked, RUNLOC ($3D into CP) is given the value 
of the first address in that command's .COM file. Some extrinsic commands (including 
user written commands) can therefore be restarted by typing the RUN command. You 
may want to change the contents of RUNLOC to point to the warmstart point of your 
program when it's entered the first time to avoid unwanted reinitializations when re- 
entered. BASIC A+ and MAC/65 do this to avoid clearing any user program which may 
be in memory when returning from CP. If you want to forbid re-entry, you need to set 
RUNLOC's high order byte ($3E into CP) to zero: 


LDY #RUNLOC+1 = ;FORBID RE-ENTRY 
LDA #0 ;TO ME 
STA (CPALOC),Y 


10.3 DEVICE HANDLERS 


As we have noted before, CIO is actually a very small program (approximately 700 
bytes). Even so, it is able to handle the wide variety of I/O requests detailed in the 
earlier parts of this section with a surprisingly simple and consistent assembly 
language interface. Perhaps even more amazing is the purity and simplicity of the OS 
interface to its device handlers. 


Admittedly, because of this very simplicity, CIO is sometimes slower that one would 


wish (only noticeably so with PUT BINARY RECORD and GET BINARY RECORD) and 
the handlers must be relatively sophisticated. But not too much $0, as we will show. 
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10.3.1 The Device Handler Table = 


At location "HATABS" in RAM, CIO has (loaded from ROM on the Atari) a list of the 
standard devices (P:, D:,E:,S:, and K:) and the addresses thereof. To add a device, 
simply tack it on to the end of the list: you need only specify the device's name (one — 
character) and the address of its handler table (more on that in a moment). 


In theory, all named device handlers under DOS XL may handle more than one physical 
device. Just as the disk handler understands "D1:" and "D2:", so could a keyboard - 
handler understand "K1:" and “K2:". DOS XL supplies a default sub-device number of 
"1" if no number is given (thus “D:" becomes "D1:"). 


Following is the layout of the HAndler TABIeS on the Atari computers: 


%= $O31A 

HATABS 
BYTE ‘P ; the Printer device 
WORD PDEVICE ; and the address of its driver 
BYTE ‘C ; the Cassette device 
WORD CDEVICE 
BYTE 'E’ ; the screen Editor device 
.WORD EDEVICE 
BYTE '‘'S’ ; the graphics Screen device 
-.WORD SDEVICE 
BYTE 'K' ; the Keyboard device 
.WORD KDEVICE 
BYTE O ; zero marks the end of the table 
WORD 0 ; ... but there's room for several 
BYTE 0 ; .. more devices 
et cetera 


10.3.2 Rules for Writing Device Handlers 


Each device which has its handler address placed into the handler address table (above) 
is expected to conform to certain rules. In particular, the driver is expected to provide 
six (6) action subroutines and an initialization routine. (In practice, the current Atari's 
OS only calls the initialization routines for its own pre-defined devices. Since this 
may change in the future, and since one can force the call to one’s own initialization 
routine, we must recommend that each driver include one, even if it does nothing.) The 
| address placed in the handler address table must point to, again, another table, the form 
| of which is shown below. 
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HANDLER 
-WORD <address of OPEN routine>-! 
.WORD <address of CLOSE routine>-1 
-WORD <address of GETBYTE routine>-1 
WORD <address of PUTBYTE routine>-1 
.WORD <address of STATUS routine>-1 
-WORD <address of XIO routine>-1 
JMP = <address of initialization routine> 


Notice the six addresses which must be specified; and note that in the table one must 
subtract one from each address (the "-1" simply makes CIO's job easier...honest). A 
brief word about each routine is given in the following pages. 


10.3.2.1 Device OPEN 


The OPEN routine must perform any initialization needed by the device. For many 
devices, such as a printer, this may consist of simply checking the device status to 
insure that it is actually present. Since the X-register, on entry to each of these 
routines, contains the IOCB number being used for this call, the driver may examine 
ICAUX1 (via LDA ICAUX1,X) and/or ICAUX2 to determine the kind of OPEN being 
requested, (Caution: CIO preempts bits 2 and 3 ($04 and $08) of ICAUX1 for read/write 
access control. These bits may be examined but should normally not be changed.) 


10.3.2.2 Device CLOSE 

The CLOSE routine is often even simpler. It should “turn off" the device if necessary 
and possible. 

10.3.2.3 Device PUT and GET BYTE Routines 

The PUTBYTE and GETBYTE routines are just what are implied by their names: the 
device handler must supply a routine to outpul one byte to the device and a routine to 
input one byte from the device. HOWEVER, for many devices one or the other of 
these routines doesn't make sense (ever tried to input from a printer?). In this case the 
routine may simply RTS and DOS XL will supply an error code. 

10.3.2.4 Device STATUS Routine 

The STATUS routine is intended to implement a dynamic status check. Generally, if 
dynamic checking is not desirable or feasible, the routine may simply return the status 
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value it finds in the user's IOCB. However, it is NOT an error under DOS XL to call the 
status routine for an unOPENed device, so be careful. 


10.3.2.5 Device Extended I/O Routine(s) 


The XIO routine does just what its name implies: it allows the user to call any and all 
special and wonderful routines that a given device handler may choose to implement. 
OS does nothing to process an XIO call except pass it to the appropriate driver. 


10.3.2.6 General Comments on Device I/O Routines 


In general, the AUXiliary bytes of each IOCB are available to cach driver. In practice, 
it is best to avoid ICAUX1 and ICAUX2, as several BASIC and OS commands will alter 
them to their will. Note that ICAUX3 through# ICAUXS may be used to pass and 
receive information to and from BASIC via the NOTE and POINT commands (which are 
actually special XIO commands). Finally, drivers should not touch any other bytes in 
the IOCBs, especially the first two bytes. 


Notice that handlers need not be concerned with PUT BINARY RECORD, GET TEXT 
RECORD, etc.: OS performs all the needed housekeeping for these user-level 
commands. 


10.3.3 Rules for Adding Things to OS 


1. Inspect the system MEMLO pointer (see SYSEQU.ASM for the actual location). 

2. Load your routine (including needed buffers) at the current value of MEMLO. 

3. Add the size of your routine to MEMLO. 

4. Store the resultant value back in MEMLO. 

5. Connect your driver to OS by adding its name and address into the handler address 
table. 

6. Fool OS so that if SYSTEM RESET is hit steps 3 through 5 will be reexecuted 
(because SYSTEM RESET indeed resets the handler address table and the value of 
MEMLO). In point of fact, step 2 is the hardest of these to accomplish. In order to 
load your routine at wherever MEMLO may be pointing, you need a relocatable (or self- 
relocatable) routine. Since there is currently no assembler for the Atari computers 
which produces intrinsically relocatable code, this is not an easy task. But it may not 
be necessary if you are writing code for your own private system instead of the general 
public. 


Step 6 is accomplished by making Atari OS think that your driver is the Disk driver 
for initialization purposes (by “stealing” the DOSINI vector) and then calling the 
Disk’s initializer yourself before steps 3 through 5 are performed again. 


244 


— EE fF 


c— 


= i ee 


DOS XL for Indus GT Reference Manual 


10.3.4 An Example Program 


This driver, included in source form on some DOS XL distribution diskettes as 
"MEM.LIS", builds a new driver and adds it to the operatiny; system. The “device” 
being driven is simply excess system memory within your cmputer. Thus, you may 
(for example) use this as a pseudo-disk file for passing data bei ween sequentially called 
programs. 


Some words of caution are in order. This driver does pot perform Step 6 as noted in 
the last section (but it may be reinitialized via a BASIC USR call). It does pot perform 
self-relocation: instead it simply locates itself above all normal }uw memory usage 
(except the serial port drivers, which would have to be loaded after this driver). If you 
assemble it yourself, you could do so at the MEMLO you find in your normal system 
configuration (or you could improve it to be self-modifying, of course). 


Other caveats pertain to the handler’s usage: it uses RAM from the contents of 
MEMTOP downward. It does pot check to see if it has bumpe¢ into BASIC's MEMTOP 
($90) and hence could conceivably wipe out programs and.» data. To be safe, don't 
write more data to the RAM than a FRE(0) shows (and preferably even less). 


In operation, the M: driver reinitializes upon an OPEN for write access (mode 8). A 
CLOSE followed by a subsequent READ access wiil allow the data to be read in the 
order it was written. 


More Cautions: don't change graphics modes between writing and reading if the 
change would use more memory (to be safe, simply don't change at all). The M: will 
perform almost exactly as if it were a cassette file, so the user program should be data 
sensitive if necessary: the M: driver will NOT itself give an error based on data 
contents. Note that the data may be re-READ if desired (via CLOSE and re-OPEN). 


The following is a suggested set of BASIC programs: 


Ending of PROGRAM 1: 


9900 OPEN #2,8,0,"M:" 
9910 PRINT #2; LEN(AS$) 
9920 PRINT #2; A$ 

9930 CLOSE #2 

9940 RUN “D:PROGRAM2" 


Beginning of PROGRAM 2: 
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100 OPEN #4,4,0,"M:" 
110 INPUT #4,SIZE 

120 DIM STRINGS(SIZE) 
130 INPUT #4, STRINGS 
140 CLOSE #4 


BASIC XL users might find RPUT/KGET and BPUT/BGET to be useful tools here instead 
of PRINT and INPUT. And, of course, users of any other language(s) might find this a 
handy inter-program communications device. 
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Section 11: DISK FILE STRUCTURE 


PROBLEM PREVENTOR: This entire section contains ¢xiremely technical 
information relating to DOS XL's maintenance of files on your diskettes. If you are 
not an advanced level programmer, you will have absolutely no need in the world to 
understand the following discussion. If you are a beginning level programmer, this is 

when looking for some kind of practice program to write. All of 
the following information is intended for the experienced prog:ammer, and no attempt 
has been made to “soften” the discussion in order to accommodate users who have no 
experience with the type of information being discussed. 


SPECIAL NOTE: The information contained in this section has been supplied by 
Future Systems as a courtesy to those users who “wanted to know”. Unfortunately, this 
information relates to performing operations which are far beyond the needs of the 
vast majority of DOS XL users; and therefore any questions arising from the use of the 
information contained in this section would de in the extreme minority. Because of 
the unbalanced nature of normal user support versus technical/advanced user support, 
very little support can be provided by Future Systems for those users who have trouble 
with the information contained in this section. Should you = counter problems with 
the information in this section, Future Systems will attempt w assist you as best as we 
can; but in general you should consider yourself "on your own". 


DOS XL version 2 was produced to provide the maximum compatibility possible with 
Atari's DOS 2.0s. In fact, the FMS used is identical to that used by Atari (for a simple 
reason: Optimized Systems wrote Atari's DOS). For reasons known best to Atari, we 
were instructed to create Atari's FMS around a linked-sector disk space management 
scheme. In essence, this means that the last three bytes of each sector in a disk file 
contain a link to the next sector in that same file. The positive result of this is that 
one produces a relatively small, memory-resident, disk manager which is nevertheless 
capable of dynamically allocating diskette space (unlike, for example, a contiguous file 
disk manager). The biggest disadvantage of the scheme scems to be that one may not 
do direct (random) access to the bytes of such files, as one can do with either a 
contiguous or mapped file allocation technique. Also, a disk error in the middle of a 
linked file means a loss of access to the rest of the file. 


The purpose of the FMS is to organize the 720 data sectors available on an Atari 810 
(or its double density equivalent) diskette into a system of named data files. FMS has 
three primary data structures that it uses to organize the disk: 


1. Volume Table of Contents (VTOC): a single disk sector which keeps track of which 
disk sectors are available for use in data files. 


2; Directory: a group of eight contiguous sectors used to associate file names with the 


location of the files’ sectors on the disk. Each Directory entry contains a file name, a 
pointer to the first data sector in the file, and some miscellaneous information. 
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3. Data Sectors: sectors containing the actual data and some control information that 
links one data sector to the next data sector in the file. Note: since double density 
diskette sectors contain 256 bytes whereas single density (810 drive) sectors contain 
only .128, certain absolute byte aumber references may vary depending upon the 
diskette in use. Throughout this chapter, in such cases, the single density number is 
given followed-by the double density number in square brackets (thus). 


11.1 Data Sectors 


A Data Sector is used to contain the file's data bytes. Each 128 [256] byte data sector 
is organized to hold 125 [253] bytes of data and three bytes of control. The data bytes 
start with the first byte (byte 0) in the sector and run contiguously up to, and 
including, byte 124 [252]. The control information starts at byte 125 (253). 


The sector byte count is contained in byte 127 [255]. This value is the actual number 
of data bytes in this particular sector. The value may range from zero (no data) to 125 
[253] (a full sector). Any data sector in a file may be a short sector (contain less than 
125 [253] data bytes). 


The left six bits of byte 125 [253] contain the file number of the file. This number 
corresponds to the location of the file's entry in the Directory. Directory entry zero in 
Directory sector $169 has a file number of zero. Entry one in Directory sector $169 
has a file number one, and so forth. The file number value may range from zero to 63 
($3F). The file number is used to insure that the sectors of one file do not get mixed 
up with the sectors of another file. 


The right two bits of byte 125 [253] (and all eight bits of byte 126 [254]) are used to 
point to the next data sector in the file. The ten bit number contains the actual disk 
sector number of the next sector Its value ranges from zero to 719 ($2CF). If the 
value is zero then there are no more sectors in the file sector chain. The last sector in 
the file sector chain is the End-Of-File sector. The End-Of-File sector will almost 
always be a short sector. 


11.2 Disk Directory 


The Directory starts at disk sector $169 and continues for eight contiguous sectors, 
ending with sector $170. These sectors were chosen for the directory because they are 
in the center of the disk and therefore have the minimum average seck time from any 
place else on the disk. Each directory sector has space for eight file entries. Thus, it 
is possible to have up to 64 files on one disk. 


A Directory entry is 16 bytes in size, as illustrated by the figure below. The directory 
entry flag field gives specific status information about the current entry. The directory 
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count field is used to store the number of sectors currently used by the file. The last 
eleven bytes of the entry are the actual file name, The primary name is left justified in 
the primary name field. The name extension is left justified in the extension ficld. 
Unused filename characters are blanks ($20). The Start Sector Number field points to 
the first sector of the data file. 


Directory Entry Structure 


Starting Length 
Byte # of Field 
of Field (bytes) Purpose of Field 


pr 


0 1 Flag byte. Meanings of bits: 
$00 Entry never used 
$80 Entry was deleted 
$40 Entry in use 
$20 Entry protected 
$02 a version 2 file 
$01 Now writing file 


1 2 Count (LSB,MSB) of sectors in file 
3 2 Start sector (LSB,MSB) of link chain 
5 8 File name, primary 

13 3 File name, extension 
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Directory Structure 










(sector $169) 
first directory 
sector 


Note: only eight file directory entries are stored per sector, even on double density 
diskettes. 
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11.3 Volume Table of Contents (VTOC) 


The VTOC sector ($168) is used to keep track of which disk sectors are available for 
data file usage. The figure below illustrates the organization of the VTOC sector. The 
most important part of the VTOC is the sector bit map. 


The sector bit map is a contiguous string of 90 bytes, each of which contains eight 
bits. There are a total of 720 (90 x 8) bits in the bit map--one for each possible 
sector on an 810 type diskette format. The 90 bytes of bit map start at VTOC byte ten 
(SOA). The leftmost bit ($80 bit) of byte SOA represents sector zero. The bit just to 
the right of the leftmost bit ($40 bit) represents sector one. The rightmost bit (bit 
$01) of byte $63 represents sector 719. 


Structure of VTOC Sector 


Starting Length 
Byte # of Field 
of Field (bytes) Purpose of Field 


0 1 Reserved (for type code) 

1 2 Total number of sectors 

3 2 Number of unused sectors 

= 5 Reserved 

10 90 Sector usage bit map Each bit represents a particular sector: a | 
bit indicates an available sector, a 0 bit indicates a sector in 
use. 

100 28 Reserved (could be used for version 2 type DOS with more than 


720 sectors per disk) 
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Section 12: SYSTEM MEMORY MAP 


PROBLEM PREVENTOR: This entire section contains extremely technical 
information relating to DOS XL's internal structure. If you are not an advanced level 
programmer, you will have absolutely no need in the world to understand the following 
discussion. If you are a beginning level programmer, this j 

when looking for some kind of practice program to write. All of the following 
information is intended for the experienced programmer, and no attempt has been made 
to “soften” the discussion in order to accommodate users who have no experience with 
the type of information being discussed. 


SPECIAL NOTE: The information contained in this section has been supplied by 
Indus Systems as a courtesy to those users who “wanted to know". Unfortunately, this 
information relates to performing operations which are far beyond the needs of the 
vast majority of DOS XL users; and therefore any questions arising from the use of the 
information contained in this section would be in the extreme minority. Because of 
the unbalanced nature of normal user support versus technical/advanced user support, 
very little support can be provided by Indus for those users who have trouble with the 
information contained in this section. Should you encounter problems with the 
information in this section, Indus will attempt to assist you as best as we can; but in 
general you should consider yourself “on your own". 


12.1 Atari Zero Page Map 


Location Usage 

0-9 System Zero Page 

A-B CPALOC Known to Atari DOS as DOSVEC 

cD DOSINI Vector to FMS Initialization 

E-42 System Zero Page 

43-49 FMS Zero Page 

4A-7F System Zero Page 

80-FF User and Language Zero Page 

80-CD BASIC XL and Atari BASIC Zero Page 
D2-FF Floating Point Zero Page 
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12.2 Atari System Memory Map - DOS XL Version 2 

Location Usage 

100-1 FF 6502 Stack Area 

200-319 System RAM 

300-30B DCB (Device Control Block) 

31A-33F Device Handler Table 

340-3BF IOCB's - 8 at 16 Bytes Each 

3C0-S7F System RAM 

580-SFF E: Text Buffer 

600-6FF User RAM 

700-varies DOS XL — File Manager and CP or Just Buffers, etc., When Using 


Extended Memory DOS Systems 

709 SABYTE Number of 128 Byte File Buffers 

70A DRVBYT Bit Map: Accessible Drives 

70C SASA _ Address of Start of Buffers 

(2E7)-BFFF User, Language, and Graphics Memory -- Note: (2E7) Means 
"Contents of Location $02E7" (LOMEM). 

A000-BFFF SuperCartridge and Atari BASIC Memory -- Also Used by DOS XL for 
File Manager and CP in “DOSXL.SUP” Version of the Extended 
Memory DOS System 

C000-CFFF Unused in Atari 400/800, OS ROM in XL-Series, Bank Switched 
With RAM 

D000-D7FF 1/O Locations 

DS00-DSFF Used by SuperCartridge for Bank Select 

D800-DFFF Floating Point ROM 


E000-E3FF Character Set ROM 
E400-FFFF OS Drivers, CIO, etc. -- in ROM 
E400-FFF9 Bank-Selectable RAM Used by DOS XL for File Manager, CP, etc., 


in the "DOSXL.XL" Version of Extended Memory DOS 
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Section 13: ERRORS 


13.1 Types of Errors 
All DOS XL operations return a status value in the IOSTAT field. DOS XL convention 


is that status values of $80 or greater indicate some sort of error. There are four 
fundamental kinds of errors that can occur with DOS XL: 


13.1.1 Hardware Errors 


Such as attempting to read a bad disk, write a read-only disk, etc. 


13.1.2 Data Transfer Errors 

Errors which occur when data is transferred between the computer and a peripheral 
device. Examples include Device Timeout, Device NAK, Framing Error, etc. 

13.1.3 Device Driver Errors 


Found by the driver for the given device, as in (for the DFM) File Not Found, File 
Locked, Invalid Drive Number, etc. 


13.1.4 OS Errors 
Usually fundamental usage problems, such as Bad Channel Number, Bad Command, etc. 


13.2 Error Code Listing 


The list of error codes which follows is not necessarily exhaustive, but it docs 
represent all error codes which will normally be returned from DOS XL or any of the 
Atari device drivers. 


Error Code 
Hex $$ Decimal Meaning 
$01 1 No error or warming. 
$02 2 Truncated ASCII line. The OS did not find a CR within BUFLEN for 


ASCII line l/O. 
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Error Code 

Hex Decimal Meaning 

$03 3 End of file look ahead. The last byte transferred from the device 


driver was its end- of-file byte. The device driver must set this 
status, so it is best to verify that the device being used is capable of 
returning this status before depending on it. 


$80 128 Operation aborted. Set by Device Handler. (Also BREAK abort on 
Atari.) 


$81 129 File already open. Program is trying to open a channel (IOCB) that 
has already been OPENed. 


$82 130 Device does not exist. The device was not found in the OS device 
table. Often caused by forgetting the disk drive name when using a 
disk file. 


$83 131 File is write only. Program tried to read from a file which can only 
be used for writing (i.e., file was OPENed with AUX1 set to 8 or 9). 


$84 132 Invalid Command. CIO has rejected your requested command. 
(Example: program tried to do XIO to a device which has no 
extended operations defined.) 


$85 133 Device/File not open. The IOCB has not been OPENed for the 
operation. Most I/O requests require that the channel be OPENed 
before a request can be made. 


$86 134 The IOCB specified is invalid. Only IOCB numbers $00, $10, $20, 
$30, $40, $50, $60, and $70 are valid. From some languages, these 
will be seen as channels 0 to 7. 


$87 135 File is read only. Program tried to write to a file which can only be 
used for reading (i.e., file was OPENed with AUX1 specified as 4 or 
6). 


$88 136 End of file. No more data in file. 

$89 137 Truncated record error. Usually occurs when the line you are reading 
is longer then the maximum record size specified in the Call to CIO 
(line oriented [/O). Can't occur with binary 1/O on version 2 OS/A+. 

S8A 138 Device timeout error. Usually set by the serial bus I/O handler 


("SIO") because a device did not respond within the allotted time as 
set by the OS. 
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Error Code 

Hex Decimal Meaning 

$8B 139 Device NAK error. Atari: serial I/O error. 

$8C 140 Serial framing out, Atari: serial I/O error. 


$8D 141 Cursor out of range for specific graphics mode you are in. (Could be 
used for similar meaning by a non-graphics device.) 


$8E 142 Serial bus overflow. Atari: computer could not respond fast enough 
to serial bus input (SIO error). 


$8F 143 Checksum error. Communications over the serial bus are garbled 
(Atari SIO error). 


$90 144 1) Device done error. A valid command on the serial bus was not 
executed properly. Atari: disk rotational speed needs ad-justment. 
2) Write protect error. The diskette has a write protect tab in place. 


$91 145 Illegal screen mode error. Bad graphics mode number. Other 
devices: AUX1 and/or AUX2 bytes in IOCB are illegal. 


$92 146 This error means the function you tried to do has not been 
implemented in the device handler. (Example: attempt to POINT 
with the graphics device.) 


$93 147 Not enough RAM for the graphics mode you requested. (Could be 
used by custom drivers for a similar message.) 


Note: A errors encountered between $A0 through $AD (below) are File 
Manager errors, 


Error Code 
Hex Decimal Meaning 
$A0 160 Either a drive # NOT between 1-8 or drive was not powered on. 
$Al 161 Too many OPEN files. No free sector buffers to use for another file. 
$A2 162 Disk FULL. No free space left on disk. 
$A3 163 Fatal system error. Either DOS has bug or bad diskette. 


S$A4 164 File mismatch. Bad file structure or POINT values wrong. 
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E.-or Code 
Decimal Meaning 

$AS 165 Bad file name. Check for illegal characters in file name. 

$A6 166 The byte count in your POINT Call was greater then 125 (for single 
density version 2) or 253 (for double density version 2). 

SA7 167 The file specified is locked (PROtected). Protected files cannot be 
erased or written to. 

SA8 168 The software interface for the specific device received an invalid 
command (example: tried to access a non-existent track or sector). 

$A9 169 All space allocated for the directory has been used up (too many 
filenames in use). 

SAA 170 The file you requested does not appear on this diskette. 

SAB 171 You have tried to POINT to a byte in a file that is not OPENed for 
update (version 2 only). 

$AC 172 Tried to OPEN a DOS | file with DOS II (version 2 only). 

SAD 173 The disk drive has found bad sectors while trying to format the disk. 
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Section 14: SHIFTING INTO SYNCHROMESH 


14.1 What Should You Already Know Before Reading This? 


This discussion assumes you are already familiar with the operation of DOS XL and of 
your Indus GT disk drive. Many terms will be used in this discussion which are 
explained in this and other manuals which relate directly with the operation of the 
Indus GT and DOS XL which are not explained for you in this discussion. 
If you are just starting to use DOS XL and your Indus GT, : i 

! The other manuals which explain the operation of your Indus G 
and DOS XL do not expect you to be running Synchromesh, and many things can 
appear to be completely different when you are using Synchromesh than when you are 
not, 


14.2 What Is "Synchromesh"? 


Synchromesh is actually a software program which “extends” the capabilities of your 
Indus GT for Atari diskette drive. Included with the Synchromesh software program is a 
new copy of DOS XL (version 2.35 or later) which provides your Atari computer with 
the necessary capabilities to communicate with an Indus GT which is running in a 
Synchromesh mode. Synchromesh and the new DOS XL are two completely 
independent software packages which require each other in order to function to their 
fullest extent, and so they are supplied by Future Systems together. 


The primary feature of Synchromesh, and one of the primary features of the new DOS 
XL, is its capability to transfer data between your Atari and your Indus GT drives at 
speeds which are multiple times faster than ordinary diskette drive data transfers. 


The synchromesh software program (called "GTSYNC.COM” on the Synchromesh 
distribution diskette) contains all the instructions necessary to: 


1) Detect which of the drives you have attached to your system are Indus GTs. 


2) Send the instructions to your Indus GT drives which are necessary to cause them to 
Start operating in Synchromesh mode. 


3) Tell the new version of DOS XL which of the drives attached to your Atari are now 
operating in Synchromesh mode and which are not. 


The new version of DOS XL contains all the instructions necessary to perform the 
following added features: 
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1) Communicate with Indus GT drives operating in Synchromesh mode at Synchromesh 
communication speeds once GTSYNC.COM has told DOS XL which drives are in 
Synchromesh mode and which are not. 


2) Automatically detect the density (cither single or double) of a diskette just before 
any file on the diskette is opened for either reading or writing. This makes the new 
version of DOS XL “density smart", and prevents you from having to type CONFIG 
commands in many situations (but not necessary all situations), This feature is strictly 
part of the new DOS XL, and has no relationship with the Synchromesh feature. 


14.3 How Do You Shift Into Synchromesh? 


The first step is to boot the Synchromesh distribution diskette in order to start 
operating under the new copy of DOS XL. Your boot drive (D1:) does not need to be 
an Indus GT. If DOS XL leaves you in Atari BASIC, type “DOS” to return to DOS XL. 
If you are using the DOS XL menu program, you will need to "Q"uit to DOS XL. You 
should have the "D1:" DOS XL command processor prompt at this point. If you have 
your Atari connected to a speaker (your T.V.'s speaker or a speaker in your video 
monitor), be sure to tum the volume up enough to hear the loading “beeps”. You'll 
want to compare the speed and tone of these “beeps” to those which are produced once 
Synchromesh is activated. 


To shift into Synchromesh, type: 
GTSYNC ON 


The command is just "GTSYNC"; but since this command will both activate and 
deactivate Synchromesh, you need to type a SPACE and then the word "ON" to tell 
GTSYNC you wish to have Synchromesh activated, If you notice that your Indus GT 
seems to be operating slower than usual while it is loading the "GTSYNC.COM" 
program, your observation would be correct. This is because your Synchromesh 
distribution diskette has been specially formatted to operate as fast as possible while 
running under Synchromesh. Unfortunately, a diskette which is perfectly formatted for 
operation under Synchromesh is less than perfectly formatted for use while 
Synchromesh is not active. 


Once GTSYNC is loaded and starts running, it will list all eight possible disk drives 
(D1:-D8:) in order and tell you if any drive responded as the indicated drive number and 
whether a drive which responded is an Indus GT and is capable of operating in 
Synchromesh mode. Once GTSYNC has checked-out all cight possible drives, it then 
tells the new copy of DOS XL that it is okay to start operating in Synchromesh mode 
with those drives which are capable of Synchromesh communications. 
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You can now see the difference between loading a software program using Synchromesh 
by placing your new Synchromesh distribution diskette into one of the Indus GTs 
connected to your Atari (in case your number one drive was not a GT), and then typing: 


D#:GTSYNC ON 


The “#" in the above command should be replaced with the number of the Indus GT 
into which you placed the Synchromesh distribution diskette. The "“D#:" part is 
something you should type; it is not the command processor's prompt. If you are 
listening to the loading “beeps” from your T.V. or monitor speaker, we think you'll be 
very impressed by their new speed and tone. These “beeps” are directly related to the 
speed at which data is being transferred between your Indus GT and the Atari. 


With Synchromesh active, you are now ready to use the INIT program to start creating 
a single density backup copy of your Synchromesh distribution diskette. When you 
use INIT with Synchromesh active to format a diskette on a Synchromesh GT, the 
diskette will be formatted for the best operation under Synchromesh. If you do not 
have Synchromesh active, or the drive you use for the format is not a Synchromesh 
GT, then the diskette will be formatted for the best operation under non-Synchromesh. 


Diskettes which are formatted for use under Synchromesh mode are completely 
compatible, and can be used, under non-Synchromesh mode and in non-Indus GT disk 
drives (provided the drive used is also capable of reading the density for which the 
diskette was formatted). Synchromesh mainly influences your GT's communications 
with the Atari, and is not a new diskette density or anything like that. Synchromesh 
will work using both single and double density diskettes. Although your GT is capable 
of reading and writing Atari's seldom used "enhanced" density, Synchromesh cannot be 
used when a GT is being used with “enhanced” density. This limitation permitted 
Synchromesh under standard single and the more popular double density (the two 
standard densities supported by DOS XL) to be used to its maximum potential. 


Before you run INIT, you may want to run the CONFIG command to make sure that the 
Indus GT you will be using to format the new diskette is operating in single density 
mode. Synchromesh will also function under double density mode, but you should 
make the backup copy of your Synchromesh distribution diskette in single density 
since the original distribution diskette is in single density. 


When you run the INIT provided with the new DOS XL, you will notice a new menu 
item. This menu item is a “second step" in the initialization of a Synchromesh 
formatted diskette. The first step is still to use the first INIT menu item to format the 
entire diskette. Be sure you are using a Synchromesh GT so that you will get a 
Synchromesh formatted diskette. Once the drive has formatted the diskette, select the 
new menu item in order to reformat the boot (or system) tracks of your Synchromesh 
formatted diskette. This new menu item works almost identically to the first menu 
item. 
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The reason for re-formatting the system/boot tracks of Synchromesh formatted 
diskettes is because Synchromesh is not active while you are first booting your 
diskette. So, to make booting as fast as possible, the new INIT permits you to re- 
format just the system tracks of the diskette in the non-Synchromesh format. 


PROBLEM PREVENTOR: Do not reformat the system tracks of a diskette which 
already contains information. Only reformat the system tracks of a diskette which you 
have just formatted using the first INIT menu item. Some of the information you may 
have saved onto a diskette may have been placed on part of the System tracks, and 
reformatting these tracks will destroy this information. Reformatting the system 
tracks of existing diskettes will only result in destroying part of the information on 
these diskettes, and will not result in these diskette automatically running faster. 


Once you've both formatted a Synchromesh diskette and then re- formatted the system 
tracks of the diskette, you should get out of INIT and then run DUPDSK to duplicate the 
Synchromesh distribution diskette onto your newly formatted diskette. When DUPDSK 
asks if you want to format the destination diskette, always say "N“o, If DUPDSK 
reformats the diskette, then you'll loose the special Synchromesh format you created 
earlier using INIT. If you are listening to your T.V. or monitor speaker, you will 
notice that DUPDSK will copy the system tracks of your Synchromesh diskette at 
pretty much the same speed as without Synchromesh active (the “beeps” won't occur as 
fast even though they are still a higher tone); but once DUPDSK starts feading and 
writing the non-system tracks, you should notice a sudden increase in speed. 


Synchromesh will continue to remain active until you do one of the following: 
1) Reboot your Atari. 


2) Turn one or more of your Indus GTs off. NOTE: If you turn a Synchromesh GT off 
and then on again, the GT will no longer be operating in Synchromesh mode; a fact 
which the DOS XL inside your Atari will not know. This means that DOS XL will not 
communicate with this GT correctly since DOS XL will try to communicate in 
Synchromesh mode, and the GT will try to communicate in standard mode. 


3) You type the command “GTSYNC OFF" to turn Synchromesh off. 


14.4 How Do You Convert Your Existing Diskettes To Synchromesh? 


Your existing diskettes will still operate fine with Synchromesh active, except you 
won't notice any true increase in speed. This is because these diskettes were Originally 
INITialized for non- Synchromesh mode. Due to the way diskette drives in general 
function, there is no safe way to just “update” your existing diskettes to be faster using 
Synchromesh. You need to copy all of the information on these slower diskettes onto 
new diskettes which you have INITialized for use with Synchromesh active. 
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To do this, use the same process as | described earlier for backing- up your 
Synchromesh distribution diskette. If you are short on diskettes (or money to hiv 
diskettes), you can first format a new diskette for use with Synchromesh, then 

the information from a non-Synchromesh diskette onto the new diskette, verify 

the information made it onto the new diskette correctly, re- format the oi 
Synchromesh diskette for use with Synchromesh, and then copy the information from 
the next non-Synchromesh diskette onto this re-formatted diskette. You can continue 
this process through your entire library. 


PROBLEM PREVENTOR: Do not try to update any copy protected or other special 
diskettes not intended to be used with DOS XL! We will discuss these types of 
diskettes later in this discussion. 


PROBLEM PREVENTOR: The version of DOS.SYS that is written on your new 
diskette must be 2.351 or higher in order to operate with Synchromesh. If you want 
your new diskette to autoboot and turn on Synchromesh, you should utilize INIT's 
Choice 3 (Write DOS.SYS Only) after first Initializing the Disk Only and then 
Reformatting the Boot Tracks Only (Choices 1 and 4 of INIT). 


14.5 How Do You Automatically Activate Synchromesh When 
Booting? 


Even if you activate Synchromesh and then write DOS XL onto a new diskette, DOS XL 
will not “boot” with Synchromesh active. There are two primary reasons for this: 


1) After being powered-on, your Indus GTs must be told to operate in Synchromesh 
mode before they will respond in that fashion. The reason for this is to insure on- 
going full compatibility between the Indus GT and many of the protected software 
diskettes currently being sold; something which is always Indus's number one priority. 
DOS XL will not boot-up with Synchromesh active since your GTs won't be expecting 
it. 


2) If DOS XL booted-up with Synchromesh active, it would also need to already know 
which numbered drives are capable of communicating in Synchromesh and which are 
not, This would require that this information be saved onto the DOS XL diskette along 
with DOS XL; and if you ever had to change which drives you had connected to your 
Atari as certain drive numbers, you'd have to go back and update all of the diskettes on 
which you have DOS XL saved with this new configuration information. 


It is still possible, however, to have Synchromesh automatically activate after DOS XL 
has booted. Simply place the command “"GTSYNC ON" into a “ST. ARTUP.EXC" file on 
your system diskette. Be sure to also include the “GTSYNC.COM" utility on your 
system diskette. The STARTUP-EXC file is discussed in the DOS XL Reference Manual. 
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14.6 What About The New DOS XL's Auto-Density Feature? 


In addition to the new DOS XL’s (version 2.35 or later) ability to communicate with 
the higher speed Synchromesh GTs, it also has the ability to auto-determine when a 
diskette is single density or double density. DOS XL always checks a special location 
on a special sector on track zero of any diskette just before trying to open a file for 
reading or writing on that diskette. This location tells DOS XL the density of the 
diskette containing the file. Most diskette operations (although not all) start by cither 
your program or some other pre-written program trying to open a file for either reading 
or writing, and once this occurs DOS XL will automatically adjust for any diskettes 
which have been changed and are of a different density from the previous diskette. 


This special piece of density information is located on a sector on the diskette which 
is always treated by DOS and your drive as single density, regardless of the actual 
density of the diskette. 


Since DOS XL requires more memory space to handle double density diskettes than 
single density diskettes, DOS XL now assumes that all diskettes will be double density 
when it is first booted. This means that DOS XL will always allocate enough memory 
to handle double density diskettes, and therefore it may use up more of your Atari's 
memory than did your previous copies of DOS XL if you normally used one or more of 
your drives in single density. The new DOS XL will not take up much more memory 
than that for which you are accustomed if you normally use double density diskettes. 
But remember, DOS XL contains new added features without getting rid of any old 
features; so it does require a little more memory for these new features. 


Ordinarily, DOS XL's auto-density feature will handle any diskette changes you make 
without any problem. But, there are certain circumstances in which you will need to 
assist DOS XL's decision concerning a diskette’s density. That is why the CONFIG 
command is still available for use with the new DOS XL. Some of the more typical 
circumstances are as follows: 


1) When your drive is currently operating in a density different than the density for 
which you wish to format a diskette. This circumstance is only valid if you have two 
or more drives, since single drive users would still use INITDBL. The way to handle 
this situation is to first insert the diskette you wish to format into the drive, and then 
use the CONFIG command to CONFIGure the drive to the density in which you wish to 
format the diskette. After CONFIG, use INIT to initialize the diskette. Remember: 
Neither CONFIG nor INIT try to open any files on any diskettes (although the 
command processor will open CONFIG.COM and INIT.COM on your default drive when 
you issue the CONFIG and INIT commands), so your non-default drives will remain in 
the density for which you CONFIGured them until you've started the diskette 
INITializing. 
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2) When you wish to re-format « diskette using a density different from that for which 
the diskette is already formatted. This situation is actually no different than the first 
situation, since neither CONFIG nor INIT will try to open any files on the diskette. 


14.7. What About Synchromesh And Software Other Than DOS XL? 


Although your Indus GT is capable of communicating with your Atari at a much higher 
speed than most other diskette drives, it is normally prevented from doing this because 
the Atari does not expect a diskette drive to be able to communicate at this higher 
speed. This causes & problem for Synchromesh, since it needs “something” to tell 
your Atari to communicate with your GT at a faster rate before your GT can start 

at this faster rate. And, even if Synchromesh communication speeds 
were to “magically” work without any “something” to help your Atari, the higher 
communication rates would interfere with many software protection schemes and would 
cause incompatibility between your GT and some of the programs you may have 
purchased. And as we mentioned before, compatibility is always the first priority at 


Future Systems. 


So, special non-DOS XL programs will not just "magically" take advantage of your 
GT's Synchromesh capabilities. What can you do about this? Always check with your 
software dealer(s) to see if the software package for which you are interested is 
available in a newer "Indus GT Synchromesh enhanced” version. Normally these newer 
software packages contain special markings to indicate they have been upgraded. And, 
if you have existing software packages which you'd like to take advantage of 
Synchromesh, contact the software's publisher. It is always possible that the 
publisher of your favorite package may have an upgrade policy which may permit you 
to get a new “Indus GT Synchromesh enhanced” version of the software for little or no 
charge, especially if you remembered to send in the publisher's software registration 
card. 


If, for some reason, your favorite nationally advertised software publisher has not yet 
upgraded their software packages to perform at Synchromesh speeds, have them contact 
our support staff here at Future Systems (818/407-1647) if they haven't already done 
40; and we'll be happy to supply them with all the necessary information free of 
charge. 
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APPENDIX A 


A SHORT GLOSSARY OF COMPUTER TERMINOLOGY 


ABSOLUTE ADDRESS The address or location in memory that represents the 
actual, physical location in memory for that particular piece of information. This 
contrasts with relative or indirect addresses -- see below. 


ACCESS TIME This is the amount of time it takes for information to become 
available once the computer has requested it. For RAM memory, this time is measured 
in billionths of a second. For disk drives, the access time is measured in thousandths 
of a second and includes the time required to move the read/write head over the 
requested track, as well as the latency or time required for the correct sector to appear 
under the read/write head. 


ACRONYM A word formed from the first letter or other letters of a compound or 
lengthy expression. For instance, PTA represents Parent Teacher Association or RAM 
represents Random Access Memory. Acronyms are usually printed in all capital letters. 


ADDRESS Refers to a specific location in memory. With 8 bit microprocessors the 
range of these addresses is from 0 to 65536 decimal or 0 to FFFF in hexadecimal 
notation. A memory map gives you the location or address where specific ROM or 
RAM routines used by your computer may be found. 


ALPHANUMERIC A character set containing any combination of letters (a-z), 
numbers (0-9) or miscellaneous characters (#$@!%&* etc.). 


ANSI An acronym for American National Standards Institute, a committee formed to 
establish standards for data processing and computer communications, recording media, 
hardware and software interface specifications, etc. 


APPLICATION A program which is designed for a specific purpose, for example, a 
Teal estate investment package or a home accounting system. 


ARGUMENT The number, variable or string which follows and gives definition to a 
function or command. 


ASCII An acronym for American Standard Code for Information Interchange -- a set 
of standard numerical equivalents for the alphabet, numbers, punctuation and special 
symbols used by the computer. 


ASSEMBLER A computer program which converts assembly language instructions 


(easier for the programmer to remember) into machine language instructions (easier for 
your computer to perform). 
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ASSEMBLY LANGUAGE A programming language that is more advanced than 
machine language. Assembly language uses easier to remember symbols or mnemonics 
(for example, LDY means LoaD Y or load the Y register of the microprocessor, etc.) 
which have one for one equivalents in machine language. 


BACKUP Making an extra copy of a master diskette (or a data diskette) or 
periodically saving your files to diskette while work is in progress so that in the event 
of disaster (computer malfunction, power outage, spilling coffee on the diskette) files 
are not lost. 


BASIC Beginner's All-purpose Symbolic Instruction Code, a programming language 
that is commonly used in many microcomputers. 


BATCH A set of commands or data that has been grouped for processing sequentially 
in a single session. 


BAUD A unit of measurement for signalling speed, normally bits per second, as a 
measure of the flow of data. 


BCD Binary Coded Decimal. A method of using groups of four binary digits to 
represent each individual digit of a decimal number. 


BINARY A numbering system used by all computer systems which is based on two 
digits (0,1). 


BIT An acronym for Binary digIT (0 or 1). There are eight bits in a byte. 

BLOCK A term representing a contiguous group of data treated as a single unit. 
BOOT A term used to describe loading a computer program or operating system. A 
“cold boot" is starting with the machine off. A “warm boot" is loading the program or 
operating system without turning off the computer. 


BUFFER A storage area used to hold data temporarily or to compensate for the rate 
of data flow. 


BUG Ap error, flaw or malfunction in either the software (program) or hardware 
(computer and/or peripherals). 


BYTE (1) A series of binary digits (usually eight bits) which together represent a 
single character, or (2) a unit of computer storage. 


CARRIAGE RETURN (sometimes shortened to RETURN) The term was derived 


from the typewriter lever used to advance to the beginning of the next line. In 
computer terminology it represent the non- printed character that returns the cursor to 
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the beginning of the next line on a CRT or a print head to the beginning of the line 
(with or without a line feed) on a printer. 


CATALOG Same as a directory; a list of items such as files or programs which are 
arranged in an easy to reference structure. 


CATHODE RAY TUBE (CRT) A device similar to a television tube, but used for 
displaying computer data and graphics. 


CHANNEL A communication link through which data and/or control information can 
be transmitted. 


CHARACTER A letter, a number or a miscellaneous symbol such as (@$%&*?. 

CHECKSUM A number which represents the sum of a series of characters or 
numbers. Typically such a number appears at the end of a sector or block of data and 
is used to verify the accuracy of the data which was read -- if the checksum number 


calculated as the sector is being read matches that which was previously recorded, it is 
much more likely thal the sector was correctly read. 


CHIP A small piece of silicon onto which an integrated, microscopic circuit is built. 
These tiny objects have revolutionized the computer world. 


CLOCK A highly accurate pulse or signal that is used by your computer to derive 
timing information or synchronize the transfer of data or control information. 


CODE A term used to describe computer instructions or symbols describing data. 


COMMAND The portion of an instruction for the computer that specifies the 
operation which is to be performed. 


COMPILER A program that translates high level program code into machine 
language code. 


COMPUTER LANGUAGE 4 set of coded instructions which are used for 
communicating with the computer. 


CONCATENATION Tying two strings together. In BASIC this is done by using a 
"+" sign, ie. NFS+NLS$. 


CONTROL KEY (often abbreviated as CTRL) Usually used in conjunction with 
another key pressed at the same lime to indicate a special cursor or program function. 


CPS Characters Per Second. 
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CPU Central Processing Unit. The central processor or “brains” of a computer 
containing main storage, arithmetic unit, and registers. 


CRC Cyclic Redundancy Check. A more sophisticated and comprehensive mathematic 
operation performed on data to ensure better transmission accuracy than a simple 
CHECKSUM operation. 


CRYSTAL Acomponent (quartz crystal) commonly found in computer systems that 
due to its precise molecular structure is used to generate highly accurate clock signals 
or timing pulses. 


CURSOR A small mobile square or dash (sometimes flashing) which runs along the 
screen indicating where the next character will appear. 


DAISYWHEEL A type of print clement that is circular or wheel shaped, with daisy 
like petals on which different printable characters are formed. Daisywheel printers 
produce excellent quality, fully formed characters, and are often referred to as typewriter 
or letter quality printers. 


DATA A general term which describes raw information such as numbers, facts, 
symbols, characters, names, information, etc. 


DEBUG The process of finding and fixing errors in a computer program. 


DECIMAL The standard, base 10 counting system which utilizes the digits 0 through 
a 


DEFAULT VALUE The path the computer program will take unless other options 
are specifically indicated by the user. 


DENSITY This refers to how closely data is packed on a disk. Track density refers 
to how closely the concentric circles or tracks of information are spaced. Single and 
Double Density refers to how closely individual bits are packed around each circle or 
track. Double density (MFM) encoding places twice as much data in the same linear 
space on the track as single density (FM) encoding. 


DIRECTORY A list or catalog of all of the files contained on a diskette or other 
storage medium. 


DISK DRIVE A peripheral device that reads and writes data to magnetic disks. 
DISK FILE A file that resides on a disk. 
DISK OPERATING SYSTEM (DOS) The software or programs that enable the 


computer to make use of disk drives for storing and retrieving information. The disk 
operating system also typically takes care of checking CRC bytes for read/write errors, 
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allocation of space on the diskette, specific file or data location on the diskette, 
formatting of blank diskettes, and so on. 


DOCUMENTATION Instructions accompanying computer programs explaining 
exactly how these programs work. 


DOT MATRIX PRINTERS A printer device which prints characters from a matrix 


of dots (often S x 7) which strike the paper in varying configurations depending on 
the desired character symbol. 


DOWN LOAD Transmitting information from one computer system to another. 


DOWN TIME The time when a computer is not functioning due to mechanical, 
electronic or human failure. 


DRIVER This refers to small programs that are used to run other programs or to 
control external devices or peripherals. 


ESCAPE (ESC) A non-printed character that is typically interpreted by the computer 
or printer (in conjunction with another character) as a control signal to perform a 
specific function. 


EXECUTE This term refers to the process of first interpreting the instruction in 
question and then performing the requested operation(s). 


EXTENSION This refers to a supplemental set of characters often appended to a file 
name (and usually separated by a period); extensions arc typically used to categorize 
file types (e.g., .BAS might be appended to BASIC file names while a file labeled .TXT 
might be appended to letters or text files). 


EXTRINSIC COMMAND (also referred to as TRANSIENT COMMAND FILES) 
Refers to commands that are not located within the computer's memory and must be 
looked up and loaded from a disk before they can be performed. 


FILE A group of organized sectors or data, that is assembled for a single function and 
is considered a single unit; this is used similar to the way a file folder would hold a set 
of related information in a filing cabinet. 


FIRMWARE Logic circuits in computer ROM which can be altered by software under 
certain circumstances, Compare “hardware” and "software". 


FLOPPY DISKETTE A flat, flexible disk of magnetic media 8, 5-1/4 or 3-1/2 
inches in diameter used to store data. 
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FORMAT (1) The process of placing tracks and sectors onto a diskette prior to use 
in the computer. This process destroys all existing data on the diskette, or (2) the 
arrangement of text, punctuation, indents, etc. on reports or a word processor. 


GIGO Garbage In Garbage Out. The input of unwanted, meaningless information 
results in the output of unwanted, meaningless information, 


HANDSHAKING Signals between the computer and various peripherals that confirm 
the sending or receiving of data. 


HARDWARE The computer and all its electronic and physical parts -- the keyboard, 
printer, monitor, disk drive, etc. 


HARD ERROR Anerror that consistently occurs with repeated retrics. In most 
systems, a hard error condition is not brought to the attention of the user unless it has 
occurred on at least 10 (and in some systems many more) successive retries. 


HEAD This refers to the magnetic read/write head which converts the computer's 
binary signals to magnetic pulses on the diskette. 


HERTZ (HZ) A unit of measurement representing cycles per second. In the United 
States AC power is nominally rated at 115 volts, 60 hertz. 


HEXADECIMAL A base 16 numbering system used by the computer. The digits 0 - 
9 and A, B, C, D, E and F are used for notation. Hexadecimal numbers are normally 
preceded by a dollar sign symbol ($) to avoid confusing them with decimal or octal 
numbers. 


HIGH LEVEL LANGUAGE This refers to computer languages which utilize 
instructions that are more english like and therefore simpler for the programmer to usc 
and understand; each high level language command usually translates into a series of 
simpler machine language statements. 


HI-RES GRAPHICS High RESolution Graphics. A method for creating computer 
graphics which allows the use of a single point on the screen, which in turn produces 
finer detail than lo-res or keyboard graphics. 


HOME A command from a key or a program which causes the cursor to move to ils 
“home” position (usually the upper left-hand corner of the screen). 


INDIRECT ADDRESS Rather than giving the specific location in memory for a 
particular piece of information, INDIRECT ADDRESSing gives instead a place in 
memory where the specific location of this information (or absolute address) may be 
found. 
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INITIALIZE (1) Setting various parameters to an initial value prior to processing, 
or (2) the process of placing tracks and sectors onto a diskette prior to use in the 
computer. This process destroys all existing data on the diskette. 


INPUT Information or data to be entered into computer storage or usage by various 
methods. 


I/O Input/Output. Refers to the flow of information both into and out from the 
computer or peripheral. 


INTERFACE An electronic link which connects two computer components making 
them compatible. 


INTRINSIC COMMAND Refers to a command that can be performed directly by 
the computer from memory without needing to load portions of the command from 
disk. 


INVERSE VIDEO Screen output which is written as dark characters on a light 
background. 


JUSTIFICATION In word processing this represents the process of controlling the 
Spacing of words and/or graphics so that an even, vertically aligned right or left hand 
margin is formed. 


KEYBOARD GRAPHICS Drawing with defined characters such as triangles, circles 
and bars that substitute for alphanumeric characters. 


KBYTE (K) A unit of measure of computer memory. 1 Kbyte = 1024 bytes and is 
sometimes called a kilobyte. 


LEAST SIGNIFICANT BIT (or BYTE) The bit or byte in the rightmost position in 
a number or word. For instance in the number 12345, the number 5 is the least 


significant or lowest value number, since the 4 represents 40, the 3 represents 300, 
and so on. 


LED Light Emitting Diode. A relatively low power, highly reliable source of light. 
Light Emitting Diodes are frequently used as indicators or status displays on computers 
and are also used in disk drives (coupled with photo-detectors) to detect track zero 


positioning of the read/write head or the presence or absence of a write protect tab on 
your diskette, etc. 


LOMEM An acronym for LOw MEMory, a specific location in memory that points to 
the lowest address in RAM that a user program can be loaded. 


LO-RES GRAPHICS LOw RESolution Graphics. A method for creating computer 
graphics using small squares of color usually the size of a single character. This 
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creates a stepped appearance in circles and diagonal lines. Uses less memory than hi- 
res graphics. 


MACHINE LANGUAGE The lowest level computer language; directly 
understandable by the computer. 


MAINFRAME (i) The central processing unit of a very large computer, or (2) the 
first generation of computers, which are huge by today’s standards. 


MEGABYTE (MB) A unit of measure of computer memory. 1 MB = 1,024,000 
bytes. 


MEMBRANE KEYBOARD A keyboard with a flat, flexible keyboard surface. Used 
on cash registers in some fast food restaurant. 


MEMORY The amount of electronic workspace available on a computer. Usually 
measured in Kbytes. 


MENU A list of programs, options, procedures or other information which is 
displayed on the screen and serves as an aid to the user in selecting a task. 


MENU-DRIVEN A feature of computer programs using menus to aid the user, 
alleviating the need to refer constantly to documentation. 


MICROCOMPUTER A general term which refers to a complete small desk- top 
computer system. 


MICROPROCESSOR A silicon chip that is the central processing unit (CPU) of a 
microcomputer. 


MINI COMPUTER A mid-range computer system, smaller than a mainframe but 
larger than a microcomputer. 


MNEMONIC Aan aid to memory, ¢.g., in naming a program, variable command, etc. 


MODEM MOdulator/DEModulator. A device which converts computer signals to 
codes which can be transmitted via telephone lines to another computer. 


MOST SIGNIFICANT BIT (or BYTE) The bit or byte in the leftmost position in a 
number or word. For instance in the number 12345, the 1 is the most significant or 
highest value element since it represents 10,000, whereas the 2 represents only 2,000, 
the 3 represents 300, and so on. 


MTBF Mean Time Between Failures. The average time between failures for any 
device. 
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MTTR Mean Time To Repair. An inte time required by a technician to repair the 
faulty device. 


NIBBLE Four bits or half a byte. Usually these represent the four least significant 
bits or most significant bits of a byte. Nibbles are often used to create BCD numbers 
(binary coded decimal). 


OEM Original Equipment Manufacturer. 


OPERATING SYSTEM (OS) The software or firmware control system under which 
all other software and hardware in the computer functions, The operating system 
manages all inpuVoutput, peripherals and deals with the application software for the 
computer's main processor. 


OUTPUT Information or data which is transmitted from computer storage to the 
screen, printer or other peripheral device. 


OVERFLOW In communications, a condition in which the buffer cannot hold all of 
the data being sent to it. Can also be a condition caused by a mathematical operation 
that generates a number that is too large for the software or hardware of the particular 
machine. 


PAGE 256 consecutive bytes of memory beginning on a page boundary. Page 
boundaries begin at address 0 and occur each 256 bytes thereafter (multiples of $100). 


PARAMETER Values which follow a command or instruction that provide additional 
information for the command. 


PARALLEL Having the same direction or occurring simultaneously. Usually refers 
to the transmission of information eight or more bits at a time, rather than serially or 
only one bit at a time. 

PARITY CHECK The simplest of the data transmission error detecting techniques. 
A bit (usually bit 8) is set to 1 or 0 to indicate whether the remaining seven bits in 
the byte contain an odd or even number of "1" bits. 


PEEK A BASIC programming statement used to read or display the decimal value of a 
specified location in memory. 


PERIPHERAL Any device for input/output in a computer system such as a printer, 
monitor, plotter, disk drive, etc. 


PIXEL The basic element (dot) of a monitor screen which is definable and addressable 
and commonly used for computer graphics. 


PLOTTER A peripheral device used to draw graphs, plot coordinate points, etc. 
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POINTER A location in memory which contains the location of another specific 
item of information. 


POKE A BASIC programming statement used to place a decimal number directly into 
a specified location in memory. 


PRINTED CIRCUIT BOARD (PCB or PC Board) A fiberglass board onto which a 
copper wiring diagram has been etched -- this copper plated wiring electrically 
connects each of the components that are later installed on the board. 


PROGRAM A sequence or series of instructions given to the computer to perform a 
specific series of tasks or functions; also referred to as “software”. 


PROMPT Direction given by the computer to the user. For example, many computer 
programs offer prompt lines at the bottom of the screen reminding the user what 
commands are available in that particular mode. 


PROTECT A method of securing a file or data against inadvertant or unintentional 
modification. This can be accomplished through physical protection of the diskette 
file or by software recording special indicators on the directory entry of the file. 


PSEUDO-RANDOM A sequence of numbers generated by the computer by a known 
formula, yet done in such a way that it is virtually impossible for the user to predict 
what number will be chosen. Used primarily in video games. 


RAM _ Random Access Memory. The computer's workspace. Information stored in 
RAM is lost when the computer is turned off unless the data there is saved to disk or 
tape before exiting. 


RANDOM ACCESS This refers to the ability of the computer or disk drive to go 
directly to the sector or segment of data it wishes to use without the necessity of 
sequentially searching through an entire record to reach the desired information. 


REGISTER A register represents a temporary storage or processing area internal to 
the microprocessor which is accessible much more quickly than main memory. 


RELATIVE ADDRESS Rather than giving a specific location in memory where a 


certain piece of information can be found, RELATIVE ADDRESSing tells you how 
many bytes higher or lower in memory than currently located this information can be 
found. 


REMARK A comment that can be made in a computer program by the programmer to 
serve as a reminder, ¢.g., "REM the next 12 lines are a subroutine that plays music”. 
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RESERVED WORDS AA list of words and abbreviations that BASIC recognizes as 
commands or functions. The reserved words cannot be used in variable names. 


RESET This term describes a software or hardware command which can be sent to 
your computer that will typically 1. Halt any program currently in operation. 2. 
Initialize or restore to power on condition defaults a number of variables. 3. Will not 
normally erase any BASIC program currently in memory (in this respect it has 
advantages over turning power to the computer off and on again). 


ROM Read Only Memory. Permanent computer memory containing such information 
as the operating system, character set, etc. This information is not alterable and is 
not lost when the computer is turned off as with RAM. 


ROUTINE A set of instructions or commands organized to direct the computer to 
perform specific action(s). A program can contain several routines although a routine 
may be considered a program by itself. 


RS232 or RS232C This represents a widely used serial interface standard (adopted 
by the Electronic Industry Association) that governs the timing, control signals and 
physical connectors used between computers and various peripherals. 


SAVE TO DISK Giving the computer a command to permanently save what is in 
RAM memory on a disk so that the computer can be turned off or a new program 
loaded. 


SERIAL Handling data sequentially or one bit at a time in the transfer of data. 


SCROLLING Movement of the text up or down so that material which is not visible 
in one frame can be displayed on the screen. 


SECTOR A sector ——_ a block of data (typically 128 or 256 bytes in length) 
which constitutes one of several segments or units composing a track. 


SEEK TIME The amount of time required for the disk drive's positioning system to 
move the read/write head to the specified track. 


SOFT ERROR A wansient, not predictable fault encountered by the disk drive. This 
can be caused by dust particles, sudden vibration of the disk drive or media, power line 
surges, or other causes. Soft errors, by definition, are recovered from by re-reading the 
sector or block of data originally ucing the error. 


SOFT-SECTORED This refers to diskettes on which the sectors or blocks of 
information comprising each track are identified by address data being recorded 
magnetically on the track by software. This contrasts with hard sectored diskettes 
where the sector separations are marked by reference holes being physically punctured 
through the diskette. 


SOFTWARE Computer programs and sub-routines. In contrast, the computer and its 
various peripherals are hardware. 
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STEPPER MOTOR A motor that rotates in precise increments each time an 
electrical pulse is applied to it. In flexible disk drives, these movements position the 
read/write head over the concentric tracks on the diskette where data is stored. 


STRING A related set of alphanumeric characters or symbols. The word "INDUS" is a 
string of five characters. String variables (as oP sed to real number or integer 
variables) are usually indicated with a dollar sign suffix; for example, X$ « DATA. 


SUBROUTINE A self-contained program within a program. When a portion of a 
program has to be executed several times it can be incorporated into 2 subroutine and 
then accessed whenever necessary. 


SYNCHRONOUS DATA TRANSMISSION The process of sending and receiving 
information having both the sending and receiving devices synchronized to a common 
clock signal. 


SYNTAX The grammatical rules of a programming language or operating system. 


TIME SHARING A technique whereby many terminals can share a centralized 
computer at the same time. 


TRACK Information on a diskette is organized in the form of concentric circles or 
tracks of recording area. Each of these tracks can be randomly accessed by the disk 
drive by moving its read/write head over any selected track location and does not 
require reading all of track one before moving to track two, etc. 


TRACKS PER INCH (TPI) A method of measuring the density of concentric circles 
or tracks of data on disks. On minifloppy diskettes, 48 tracks per inch is standard 
track density, 96 tracks per inch is referred to as double track density. 


TRANSMISSION SPEED This is the speed at which data is sent from one device, 
such as the computer, to another device, such as a printer or modem. Transmission 
speed is usually measured in the number of bits per second or BAUD rate. 


TRUNCATE To shorten by cutting off. 


USER-FRIENDLY A term used by the computer industry to describe a program that 
is easy to use without extensive documentation. 


USER MEMORY Memory that can be accessed and changed by the user. This is 
usually the yey of the computer's addressing range that remains once the operating 
system and BASIC ROM areas have been removed. 


UTILITY Non-application programs that allow the user to perform various functions 
closer to machine level than normal. Their varied purposes include copying files, 
Tenumbering programs, compiling code to make the program run faster, etc. 


VARIABLE A symbol used in a program to which a value can be assigned. 
Variables can represent real numbers (¢.g., LET X = 10) or, when followed by a "$" 
symbol or - | indicator, can represent a group or string of characters or numbers 
(e.g., LET GS = BURLESQUE). 
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WILD CARD Symbols used to represent one or more characters of any value. The 
expression is derived from and is used in a similar way to card games, where the “wild 
card" can be used to represent any card chosen by the dealer or in this case the 
computer. 


WORD PROCESSOR A computer Program which allows the computer to function as 
a powerful typewriter. Text files can be manipulated quickly and easily -- blocks of 
text can be moved without retyping, spelling errors corrected, editorial or global 
changes made, etc. 


WRITE ENABLE The process of modifying storage media to allow a disk or tape 
drive to record information on this media. On a minifloppy diskette, this involves 
removing the write protect sticker or tab from the media, or alternately on an Indus 
GT, by pressing the protect button to turn off the electronic write protect function. 


WRITE PROTECT The process of physically inhibiti — computer or disk drive 
from being able to eye fed accidentally record information on your diskette. 
This is accomplished on a mini ppy diskette by — a write protect tab or sticker 
over the write enable notch on the side of the iskette jacket, or alternately on an 


Indus GT, by pressing the protect button to turn on the electronic write protect 
function. 
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DECIMAL/HEXADECIMAL/BINARY CONVERSION TABLE 


Decimal Hex Binary Decimal Hex Binary 

0 0 0000 0000 32 20 0010 0000 
1 1 0000 0001 33 21 0010 0001 
2 2 0000 0010 34 22 0010 0010 
3 3 0000 0011 35 23 0010 0011 
4 4 0000 0100 36 24 0010 0100 
5 5 0000 0101 37 25 0010 0101 
6 6 0000 0110 38 26 0010 0110 
7 7 0000 0111 39 27 0010 0111 
8 8 0000 1000 40 28 0010 1000 
9 9 0000 1001 41 29 0010 1001 
10 A 0000 1010 42 2A 0010 1010 
11 B 0000 1011 43 2B 0010 1011 
12 Cc 0000 1100 44 2C 0010 1100 
13 D 0000 1101 45 2D 0010 1101 
14 E 0000 1110 46 2E 0010 1110 
15 F 0000 1111 47 2F 0010 1111 
16 10 0001 0000 48 30 0011 0000 
17 11 0001 0001 49 31 0011 0001 
18 12 0001 0010 50 32 0011 0010 
19 13 0001 0011 51 33 0011 0011 
20 14 0001 0100 52 34 0011 0100 
21 15 0001 0101 53 35 0011 0101 
22 16 0001 0110 54 36 0011 0110 
23 17 0001 0111 55 37 0011 0111 
24 18 0001 1000 56 38 0011 1000 
25 19 0001 1001 57 39 0011 1001 
26 1A 0001 1010 58 3A 0011 1010 
27 1B 0001 1011 59 3B 0011 1011 
28 1C 0001 1100 60 3C 0011 1100 
29 1D 0001 1101 61 3D 0011 1101 
30 1E 0001 1110 62 3E 0011 1110 - 
31 1F 0001 1111 63 3F 0011 1111 
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Decimal Hex 


64 
65 
66 
67 


Binary 


0100 0000 
0100 0001 
0100 0010 
0100 0011 


0100 0100 
0100 0101 
0100 0110 
0100 0111 


0100 1000 
0100 1001 
0100 1010 
0100 1011 


0100 1100 
0100 1101 
0100 1110 
0100 1111 


0101 0000 
0101 0001 
0101 0010 
0101 0011 


0101 0100 
0101 0101 
0101 0110 
0101 0111 


0101 1000 
0101 1001 
0101 1010 
0101 1011 


0101 1100 
0101 1101 
0101 1110 
0101 1111 
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Reference 


Binary 


0110 0000 
0110 0001 
0110 0010 
0110 0011 


0110 0100 
0110 0101 
0110 0110 
01100111 


0120 1000 
0110 1001 
0110 1010 
0110 1011 


0110 1100 
0110 1101 
0110 1110 
0110 1111 


0111 0000 
0111 0001 
0111 0010 
0111 0011 


0111 0100 
0111 0101 
0111 0110 
01110111 


0111 1000 
0111 1001 
0111 1010 
0111 1011 


0111 1100 
0111 1101 
0111 1110 
0111 1111 
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Decimal Hex Binary Decimal Hex Binary 

128 80 1000 0000 160 AO 1010 0000 
129 81 1000 0001 161 Al 1010 0001 
130 82 1000 0010 162 A2 1010 0010 
131 83 1000 0011 163 A3 1010 0011 
132 84 1000 0100 164 A4 1010 0100 
133 85 1000 0101 165 AS 1010 0101 
134 86 1000 0110 166 A6 1010 0110 
135 87 1000 0111 167 Al 1010 0111 
136 88 1000 1000 168 A8 1010 1000 
137 89 1000 1001 169 AQ 1010 1001 
138 8A 1000 1010 170 AA 1010 1010 
139 8B 1000 1011 171 AB 1010 1011 
140 8C 1000 1100 172 AC 1010 1100 
141 8D 1000 1101 173 AD 1010 1101 
142 8E 1000 1110 174 AE 1010 1110 
143 8F 1000 1111 175 AF 1010 1111 
144 90 1001 0000 176 BO 1011 0000 
145 91 001 0001 177 Bl 1011 0001 
146 92 1001 0010 178 B2 1011 0010 
147 93 1001 0011 179 B3 1011 0011 
148 94 1001 0100 180 B4 1011 0100 
149 95 1001 0101 181 B5 1011 0101 
150 96 1001 0110 182 B6 1011 0110 
151 97 1001 0111 183 B7 1011 0111 
152 98 1001 1000 184 B8 1011 1000 
153 99 1001 1001 185 B9 1011 1001 
154 9A 1001 1010 186 BA 1011 1010 
155 9B 1001 1011 187 BB 1011 1011 
156 9C 1001 1100 188 BC 1011 1100 
157 9D 1001 1101 189 BD 1011 1101 
158 9E 1001 1110 190 BE 1011 1110 
159 oF 1001 1111 191 BF 1011 1111 


280 


7 DOS XL for Indus GT Reference Manual 


Decimal Hex Binary Decimal Hex Binary 
[ 192 CO ——- 1100 0000 224 EO —-1110 0000 
193 C1 _—-1100 0001 225 El _—‘1110 0001 
194 C2 —- 1100 0010 226 E2 —1110 0010 
195 C3. —- 1100 0011 227 E3 —-:1110 0011 
L 196 C4 1100 0100 228 E4 —-1110 0100 
197 CS 11000101 229 ES _—‘1110 0101 
198 C6 ~—-:1100 0110 230 E6 —-1110 0110 
7 199 C7 ~—s-:1100 0111 231 E7 ‘11100111 
200 C8 —-1100 1000 232 E8 —-1110 1000 
201 C9 —-1100 1001 233 E9 —-1110 1001 
202 CA 1100 1010 234 EA _1110 1010 
— 203 CB 1100 1011 235 EB 1110 1011 
204 cc 11001100 236 EC 1110 1100 
205 CD 1100 1101 237 ED ‘1110 1101 
_ 206 CE 11001110 238 EE 11101110 
207 CF 1100 1111 239 EF 11101111 
208 DO —1101 0000 240 FO —_1111. 0000 
— 209 D1 _—‘1101 0001 241 Fl —-1111 0001 
210 D2 ~—-1101 0010 242 F2 —-1111 0010 
211 D3. —:1101 0011 243 F3 1111 0011 
_ 212 D4 —1101 0100 244 F4 —1111 0100 
213 DS _—:1101 0101 245 F5 —- 1111 0101 
214 D6 —«-1101 0110 246 F6 —«-1111 0110 
7 215 D7 ~—:1101 0111 247 F7 1111 0111 
216 D8 —:1101 1000 248 F8 —-1111 1000 
217 D9 —:1101 1001 249 F9 1111 1001 
218 DA 1101 1010 250 FA 1111 1010 
219 DB ‘1101 1011 251 FB 1111 1011 
220 DC 1101 1100 252 FC 1111 1100 
221 DD ‘1101 1101 253 FD ‘1111 1101 
222 DE 1101 1110 254 FE 11111110 
223 DF ‘1101 1111 255 FF 1111 1111 
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APPENDIX C 


OTHER FILES ON YOUR DISKETTE 
C1 CONFIG.BAS A Guide To Writing Your Own Density Utility 


The following program listing is offered as a guide or model for the advanced 
programmer who may wish to write his own density configuration program or 
incorporate such a routine within some other program he wishes to write. As we have 
previously noted, special, highly technical information of this type will reccive only 
modest levels of support from our technical support staff. 


10 REM BASIC DISK DRIVE STATUS/CONFIGURATION PROGRAM 

20 REM BY GREG FARRIS 2/13/84 

30 DIM TBLS(12),EXC$(4), DENS(7), DPS(3) 

40 TBLS=" J 

50 OPEN #1,4,0,"K:" 

60 GRAPHICS 0:POKE 752,1 

70 POKE 53774,112:POKE 16,112:? :? "WHICH DRIVE (1-8)":? "OR ESC TO 
EXIT?":GET #1, DRIVE 

80 IF DRIVE=155 THEN 70 

90 IF DRIVE=27 THEN POKE 580,0:RESTORE 1000:FOR X=1 TO 4:READ E:EXCS(X, 
X)=CHRS(E):NEXT X:X=USR(ADR(EXCS)) 

100 IF DRIVE<49 OR DRIVE>S6 THEN 70:? DRIVE-48 

110 RAMTOP=HI=PEEK(RAMTOP)-20 

120 RAM=HI*256-1:POKE 769,DRIVE-48 

130 DCB=768:REM BASE ADDRESS OF DEVICE CONTROL BLOCK 

140 GOSUB 470:GOSUB 740 

143 REM 

145 REM *** SELECT SIMPLE OR CUSTOM CONFIGURATION *** 

150 ? :? :? “SIMPLE OR CUSTOM CONFIGURATION?";GET #1,X:IF X=155 THEN 150 
160 IF X=83 THEN GOSUB 280:GOTO 470 

170 IF X=67 THEN GOSUB 580:GOTO 190 

180 IF X<>67 OR X<>83 THEN 150 

183 REM 

185 REM *** WRITE TO OPTION TABLE *** 

190 POKE DCB,49:REM SERIAL BUS I. D. 

200 POKE DCB+1,DRIVE:REM DRIVE NUMBER 

210 POKE DCB+2,79:REM WRITE TO OPTION TABLE 

220 POKE DCB+3,128:REM STATUS AS OUTPUT 

230 POKE DCB+5,HI:POKE DCB+4,0:REM BUFFER ADDRESS HIGH AND LOW 

240 POKE DCB+6,15:REM TIMEOUT VALUE 

250 POKE DCB+8,12:REM NUMBER OF BYTES 

260 POKE DCB+9,0:REM HIGH BYTE NUMBER OF BYTES 

270 GOSUB 530:POKE 580,0:RESTORE 1000:FOR Xe1 TO 4:READ 
a -CHRSEDNEXT X:X=USR(ADR(EXCS)) 

275 REM *** SIMPLE CONFIGURE *** 

280 oy :? 3" WHICH DENSITY:":? :? ;" 1. SINGLE”:? ;" 2. DOUBLE”:? >" 3. STATUS 
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290 GET #1,DEN 

300 IF DEN=155 THEN DEN«=50:GOTO 360 

310 IF DEN<49 OR DEN>51 THEN 290 

320 IF DEN«51 THEN GOSUB 740:GOTO 70 

330 IF DEN=49 THEN GOSUB 420:GOTO 190 

340 IF DEN=155 THEN DEN=50 

345 REM 

350 REM *** DOUBLE DENSITY ROUTINE ** 

360 FOR X=1 TO 10 

370 TBLS(6, -CHRE(4): TBLS(7,7)=CHRS$(1):TBL$(8,8)=CHR$(0) 
380 TBL=ASC(TBLS(X,X)) 

390 POKE RAM+X,TBL 

400 NEXT X:GOSUB 190 

405 REM 

410 REM *** SINGLE DENSITY ROUTINE ** 

420 FOR X=1 TO 10 

430 TBLS(6,6)=CHR$(0):TBLS(7,7)«CHRS(0):TBLS(8,8)=CHR$(128) 
440 TBL=ASC BLS(X.X)): POKE RAM+X, TBL 

450 NEXT X:R 

455 REM 

460 REM *** READ OPTION TABLE *** 

470 POKE DCB+2,78:REM READ OPTION TABLE 

480 POKE DCB+43,64:REM STATUS AS INPUT 

490 POKE DCB+4,0:REM BUFF ADDR LOW 

500 POKE DCB+5,HI:REM BUFF ADDR HIGH 

510 POKE DCB+6,7:REM TIMEOUT VALUE 

520 POKE DCB+8,12:REM NUMBER OF BYTES 

530 RESTORE :FOR X=1 TO 4:READ D:EXC$(X,X)=CHRS(D):NEXT X 
540 X=USR(ADR(EXC$)):REM EXECUTE OPTION TABLE COMMAND 
550 IF PEEK(DCB+3)=138 THEN ? “DRIVE ";DRIVE-48;" DOES NOT 
RESPOND!":GOTO 70 

560 IF PEEK(DCB+3)=139 THEN ? “DRIVE “;DRIVE-48:" NOT 
CONFIGURABLE!":GOTO 70 

570 RETURN 

573 REM 

575 REM *** CUSTOM CONFIGURE *** 

580 ?" TYPE IN DESIRED VALUE":?"OR RETURN TO LEAVE UNCHANGED”:POKE 


752,0 

590 TRAP 610 

600 ? :?:? "TRACKS=";TR;:? “";:INPUT TR:POKE RAM+1,TR 

610 TRAP 630 

620 ? “STEP RATE IN MSECS. ";SR;:? "";:INPUT TR:POKE RAM+2,TR 

630 TRAP 650 

640 ? "SECTORS PER TRACKs=";ST;:? “";:INPUT ST:POKE RAM+4,ST:POKE RAM+3,0 
og ? "NUMBER OF SIDES?" SIDES:: So ;:GET #1,SIDES:IF SIDES>50 THEN ? -GOTO 
660 ? SIDES-48:POKE RAM+5,SIDES-49 

670 ? "DENSITY?";DENS; 

680 ?"";:GET #1: :IF X=68 THEN PRINT "DOUBLE”:POKE RAM+6,4:GOTO 700 

685 IF X=155 THEN ? :GOTO 700 

690 ? "SINGLE":POKE RAM+6,0:DENS$="SINGLE" 
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ba angered ;3BS;:? "";: INPUT BS:IF BS<255 THEN POKE RAM+7,0:POKE 
AM+ 

710 IF BS>=256 THEN POKE —* BS/256:POKE RAM+8,0 
720 ? "DRIVE PRESENT?" ;DP$ 

723 GET #1,X:IF X=89 THEN ? OES": POKE RAM+9,255:GOTO 730 
725 IF Xu155 THEN GOTO 730 

727 ? "NO":POKE RAM+9,0:DP$="NO" 

730 RETURN 

733 REM 

735 REM *** PRINT RESULTS *** 

740 DRIVE=PEEK(769) 

750 TR=PEEK(RAM+1):TBLS(1,1)=CHRS(TR 

760 SRAPEEKIRAM.2 ve 

770 IF SR=0 THEN SR=30: 

780 IF SR=1 THEN Sh220-COTO 310 

790 IF SR=2 THEN SR=12:GOTO 810 

800 IF SR=3 THEN SR=6 

810 ST=PEEK(RAM+4):TBLS(4, S)=CHRSNS) IF ST<256 THEN TBLS(3,3)=CHRS$(0) 
820 NS«PEEK(RAM+5):TBLS(5,5)=CHR 

830 IF NS=0 THEN SIDES=1:GOTO 85 

840 SIDES=2 

850 IF PEEK(RAM+6)=0 tg ol aati cys POKE RAM+6,0: 
TBLS$(6,6)=CHRS(0):GOTO 8 

860 DEN$="DOUBLE": POKE! RAMs, 4:TBLS$(6,6)=CHRS$(4) 

870 BS=PEEK(RAM+7)*256+PEEK(RAM48): TBLS(7, a 
880 DP=PEEK(RAM+9): IF DP=0 THEN DP$="NO": 

890 DP$="YES" 

900 ?:? "DRIVE=";DRIVE 

910 ? "TRACKS=";TR 

920 ? "STEP RATE=" a 

930 ? "“SECTORS/TRACK 

940 ? "NUMBER OF SIDES SIDES 

950 ? "DENSITY=" a 


960 ?"B SECTOR=" 
970 ? "DRIVE PRESENT=" DPS 
980 RETURN 


990 DATA 104,76,89,228 
1000 DATA 104,76,116,228 
1010 GET #1,CHAR:? CHAR:GOTO 1010 
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C.2. GTRPM.COM A Speed Checking Utility For The Indus GT 


One of the most common sources of disk drive reading and even formatting problems 
has to do with the disk drive spinning the diskette at an incorrect rotational speed. 
This can cause various types of read errors (G5, G4, etc.), format errors (F9, etc.) and 
can even cause software compatibility errors with certain protection schemes whose 
sector interleave timing requirements are exceptionally stringent. Finding out that 
your drive is operating at the correct number of revolutions per minute is a good 
preventive maintenance practice -- like seeing your dentist twice a year. 


The GTRPM Utility can be operated either as an extended command from the DOS XL 
Menu or from the Command Processor level. In either case, all you need to do is type: 


GTRPM 


and then press <RETURN>. The next screen you will see gives you several choices; 
you press 


OPTION - To Re-Boot Your Diskette 
SELECT - To Tell The RPM Tester You Wish To Test Another Drive 
DRIVE NUMBER - To Tell The RPM Tester Which Drive You Wish To Test 


The drive number you select must be powered on, connected to the computer, and 
contain a formatted diskette. Once you have selected a valid drive number and pressed 
the <RETURN> key, you will be notified that the program is "READING DRIVE NOW". 
The GTRPM program determines the rotational speed of the diskette (and drive) by 
reading a single sector's address mark 100 times and then averaging the number of 
revolutions per minute to which this equates. The tones of the reminding beeps and 
the colors of the screen will correspond to the program's evaluation of your drive's 
rotational accuracy which will be noted for you on the screen as follows: 


288 +/- 15 RPM = PERFECT 
288 +/- 4.0 RPM = SPEED IS OK 
288 +/- 4+ RPM = TOO FAST/TOO SLOW 
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C3 RAM130.COM A RAM Disk Utility for 130XE Computers 


Your DOS XL System Master Diskette also contains a file called RAM130.COM. This 
public domain program was written by Josef W. Segur on 5-25-85, and was modified 
by Optimized Systems, Inc. on 6-14-85 This file will only be of use to you if you 
have an Atari 130XE computer (or another model of Atari computer which has been 
upgraded with a totally compatible enhancement). The purpose of this utility is to 
allow you to use the extra 64K of RAM as an electronic disk -- an electronic disk can 
cause incredible performance improvements in many computer applications, but has 
some limitations as well. 


On the positive side, an “electronic” disk can reach your information in billionths of a 
second, compared with thousandths of a second with a standard electro-mechanical disk 
drive. Any software which will operate under standard DOS XL can most likely utilize 
this RAM Disk as though it were just another physical disk drive -- but with 
substantially faster access to your data. 


On the negative side, not all software -- especially copy protected programs — will be 
able to recognize this disk drive. The RAM Disk resides in 64K and is therefore 
smaller than even a single density disk. Any power problems or system lock up 
conditions will most likely wipe out the RAM Disk without any hope of recovery 
(where did those electrons go?) The addition of an additional drive means that some 
additional memory will be used up in the primary computer bank (only 384 bytes) to 
keep track of this extra drive; this can cause some programs which expect the low 
memory location to be in a specific place to not operate properly. A RAM Disk 
means an extra step when shutting down your system; the information it contains must 
be copied to a physical diskette if you will need the information it contains at some 
future date. 


You will need to experiment somewhat to find out if the RAM Disk can be used with 
your software. Although the negative aspects of appear ominous, the speed and power 
it can provide will be hard to resist once you have tried it. 


Installing the RAM130.COM File 


The RAM130 like many other "COM" files can be installed from either the extended 
command function of the main MENU or from the command processor level, in either 
case typing "RAM130" and then <RETURN> is all that is required. For those of you 
who know that you'll always want it turned on, a STARTUP.EXC file can be created 
which contains the instruction "RAM130", or it can be renamed to AUTORUN.SYS. 


At the present time, however, the RAM130.COM file does pot work with Synchromesh 
enhanced versions of DOS XL. Therefore you will need to create a new System Master 
Diskette containing DOS XL Version 2.2. This may be accomplished by booting either 
your GT Estate Wordprocessor or GT Data Manager, exiting the wordprocessor or data 
base manager (see the sections dealing with each of these programs as to how this may 
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be accomplished), re-insert your original System Master Diskette, use Init or Initdbl to 
put DOS XL 2.2 on a new diskette, and use Copy to transfer any files you need from 
your original System Master Diskette to your new one. 


After this point, your RAM Disk will be available as drive D8: and almost all normal 
disk functions can be performed by it . It will contain no information when it is first 
created so you will have to copy files to it or specify it as a data disk for your 


program. 
Technical Information 


The following information has been provided for those of you who are more 
technically inclined and want to know what's going on in your computer. It is 
absolutely not necessary to know or understand this information in order to enjoy the 
benefits of the RAM Disk! 


RAMI130.COM configures an Atari 130XE’s extra RAM for use with DOS XL 
version 2.351. The RAM Disk (D8:) created by the RAM130.COM has 503 
free sectors, 4 through 359 and 369 through 515. Sectors 360 through 368 
contain the VTOC and Directory (same as a physical disk). Boot sectors 1 
though 3 do not exist, but a read or write attempt returns a “success” status 
code. Any attempt to access a sector 516 or higher returns a 144 error 


The bit map in the VTOC created with the RAM Disk indicates that sectors 
516 through 720 are in use so the FMS will not attempt to write to them. 
However, if you reformat the RAM Disk, the driver code merely corrects the 
maximum and free sector counts in the VTOC written by the FMS. Ths same 
logic applies to a sector copy routine like the DUPDSK extrinsic command of 
DOS XL, which directly copies each sector shown in use by the bit map. The 
FMS merely maintains the sector counts for your convenience, and actually 
uses the bit map for all of its decisions as to which sectors are available. 
Therefore this logic allows duplicating an actual disk to the RAM Disk and 
back to disk again. It is strongly recommended, however, that a COPY with 
wildcards be used instead, as this approach will maintain both the bit map and 
sector counts. 


The steps which the RAM130 program follows upon installation are outlined 
below: 


hs Verifies that the DOS is a valid version of DOS XL; it will exit if 
it is not a valid version. 


2. Verifies that the computer actually has extra RAM at location 
4000 hex; it will exit if there is no RAM at this location. 
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3. Copies the relocatable driver code to the end of the FMS, and 
sets the drive bit in DRVBYT for drive D8:. 


4. Replaces the FMS calls to SIO and the OS Resident Disk Handler — 
with calls to the relocated code. 


5. If the FMS was the standard Version 2, it kills the “write DOS" 
function by pointing it to the Invalid Device Command error return 
location. 


6. Adds the length of the driver code to SASA which sets the FMS 
start of allocation address word. 


7. Reinitializes the FMS. 


8. If the extra RAM is not already formatted as RAM Disk, it clears 
the RAM to zeroes and writes the VTOC for the 503 available 
sectors. 


NOTES: If the RAM130 is run again after it is already installed, it 
will exit at step one above thus avoiding multiple copies of the 
RAM Disk driver code. Step number 8 permits rebooting the 
computer by forcing a coldstart; rebooting without turning off the 
computer power will not destroy the contents of the RAM Disk. 


PROBLEM PREVENTOR: The RAM Disk will obviously be incompatible 
with any program which uses the extra RAM on the 130XE for some other 


purpose. 


PROBLEM PREVENTOR: Any program which does not use the DOS File 
Management System (FMS) for all of its disk handling will probably not 
work. As with the addition of any other single density disk drive, the FMS 
allocates an additional 128 byte space for the VTOC. Therefore, installing 
the RAM Disk increases LOMEM by 384 bytes. (The exception to this would 
be when the DOSXL.SUP file is active and both DOS XL and its buffers are in 
the SuperCartridge — not in low memory — in which case LOMEM is not 
moved). The modifications performed by the RAM130 program affect the 
FMS code which would be written by a “write DOS.SYS" Operation. Since the 
RAM Disk driver code would not yet be loaded when normal boot code 
attempts serial I/O, a cold boot operation would immediately lock up the 
computer. It would be necessary in this instance to power down, losing all 
information contained in the RAM Disk. The installation code forces a 168 
erzor (invalid command) to be returned in the event that a “write DOS.SYS” 
command is issued; if you see a 168 error do not attempt to boot from the 
disk which was being written at that time. 
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